[JScript] function PreAuthenticate(request : WebRequest, credentials : 
ICredentials) : Authorization; 

Description 

Returns an instance of the Systein.Net.Authorization class for an 
authentication request to a server. 

Return Value: An System.Net.Authorizatioii instance containing the 

authorization message for the request. 

When the System.Net.IAuthenticationModule.CanPreAutheiiticate 

property is true , the 

System.Net.IAuthenticationModule.PreAuthenticate(System.Net.WebRequest 
,System.Net.ICredeiitials) method will return an instance of the 
System.Net.Authorization class containing an authentication message. The 
System.Net. WebRequest instance associated with the authentication request. The 
credentials associated with the authentication request. 

ICertificatePoHcy interface (System.Net) 

PreAuthenticate 



Description 

Validates a server certificate. 

The System.Net.ICertificatePolicy interface is used to provide custom 
security certificate validation for an application. The default policy is to allow 
valid certificates, as well as valid certificates that have expired. To change this 
policy, implement the System.Net.ICertificatePolicy interface with a different 
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policy, and then assign that policy to 
System.Net.ServicePomtManager.CertificatePolicy . 

CheckValidationResult 

[C#] bool CheckValidationResult(ServicePoint srvPoint, X509Certificate 
certificate, WebRequest request, int certificateProblem); 

tool CheckVaUdationResult(ServicePoint* srvPoint, X509Certificate* 
certificate, WebRequest* request, int certificateProblem); 
[VB] Function CheckValidationResuk(ByVal srvPoint As ServicePoint, ByVal 
certificate As X509Certificate, ByVal request As WebRequest, ByVal 
certificateProblem As Integer) As Boolean 

[JScript] fiinction CheckVaHdationResult(srvPoint : ServicePoint, certificate : 
X509Certificate, request : WebRequest, certificateProblem : int) : Boolean; 

Description 

Validates a server certificate. 
Return Value: true if the certificate should be honored; otherwise, false . 

The 

System.Net.ICertificatePolicy.CheckVaIidationResult(Systein.Net.ServicePoi 
nt,System.Security.Cryptography.X509Certificates.X509Certificate,Systein.N 
et.WebRequest,System.Int32) method implements the application certificate 
validation policy. The method can examine the srvPoint , certificate , request , and 
certificateProblem parameters to determine whether the certificate should be 
honored. The System.Net.ServicePoiiit that will use the certificate. The certificate 
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to validate. The request that received the certificate. The problem encountered 
when using the certificate. 

ICredentials interface (System.Net) 

CheckValidationResult 
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Description 

Provides the base authentication interface for retrieving credentials for Web 
client authentication. 

The System^NetJCredentials interface provides the 
System.Net.ICredentials.GetCredentiaI(System.Uri,System.String)nriethodto 

objects that supply network credentials to applications. 
GetCredential 

[C#] NetworkCredential GetCredential(Uri uri, string authType); 

[C++] NetworkCredential* GetCredential(Uri* uri. String* authType); 

[VB] Function GetCredential(ByVal uri As Uri, ByVal authType As String) As 

NetworkCredential 

[JScript] function GetCredential(uri : Uri, authType : String) : NetworkCredential; 
Description 

Returns a System.Net.NetworkCredential object that is associated with 
the specified URI, and authentication type. 

Return Value: The System.NetNetworkCredential associated with the specified 
URI and authentication type, or if no credentials are available, null . 
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TheSystem.Net.ICredeiitials.GetCredential(System.Uri,System.String) 
method returns a System.Net.NetworkCredeiitial instance that contains the 
credentials associated with the specified URI and authorization scheme. When no 
credentials are available, the 

System.Net.ICredentials.GetCredential(System.Uri,System.Strmg) method 
returns null . The System.Uri that the client is providing authentication for. The 
type of authentication, as defined in the 

System.Net.IAutheiiticationModule.AuthenticatioiiType property. 
IP Address class (System.Net) 
GetCredential 



Description 

Provides an Internet Protocol (IP) address. 

The System.Net.IP Address class contains the address of a computer on an 
IP network. 

GetCredential 

[C#] public static readonly IP Address Any; 
[C++] public: static IP Address* Any; 
[VB] Public Shared ReadOnly Any As IPAddress 
[JScript] pubHc static var Any : IPAddress; 

Description 
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Provides an IP address indicating that the server should Usten for client 
activity on all network interfaces. This field is read-only. 

The System.Net.Sockets.Socket.Bind(System.Net.EndPoint) method 

uses the System.Net.IPAddress.Any field to indicate that a 
System.Net.Sockets.Socket instance should listen for client activity on all 
network interfaces. 
GetCredential 

[C#] public static readonly IP Address Broadcast; 
[C++] public: static IP Address* Broadcast; 
[VB] Public Shared ReadOnly Broadcast As IP Address 
[JScript] public static var Broadcast : IP Address; 

Description 

Provides the IP broadcast address. This field is read-only. 
The System.Net.IPAddress.Broadcast field is equivalent to 
255.255.255.255. 

GetCredential 

[C#] public static readonly IP Address Loopback; 
[C++] public: static IP Address* Loopback; 
[VB] Public Shared ReadOnly Loopback As IPAddress 
[JScript] pubHc static var Loopback : IPAddress; 

Description 
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1 Provides the IP loopback address. This field is read-only. 

2 The System.Net JPAddress.Loopback field is equivalent to 127.0.0.1 in 

3 network byte order. 

4 GetCredential 



6 [C#] public static readonly IP Address None; 

7 [C++] public: static IP Address* None; 

8 [VB] Pubhc Shared ReadOnly None As IP Address 

9 [JScript] public static var None : IP Address; 

10 

n Description 

12 Provides an IP address indicating that no network interface should be used. 

13 This field is read-only. 

14 The System.Net.Sockets.Socket.Bmd(System.Net-EndPoiiit) method 

15 uses the System.Net JPAddress.None field to indicate that a 

16 System.Net.Sockets.Socket instance should not Hsten for chent activity. 



5 
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IP Address 
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Example Syntax: 
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GetCredential 
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[C#] pubUc IPAddress(long newAddress); 

[C++] public: IPAddress( int64 newAddress); 

[VB] Public Sub New(ByVal newAddress As Long) 
[JScript] public function IPAddress(newAddress : long); 



25 
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Description 

Initializes a new instance of the System.Net.IP Address class with the 
specified address. 

The System,Net.IP Address instance is created with the 
System.Net.IPAddress,Address property set to newaddress . The integer value of 
the IP address. 

Address 

GetCredential 

[C#] public int Address {get; set;} 

[C++] public: property int get_Address();public: property void 

set_Address(int); 

[VB] Public Property Address As Integer 

[JScript] public function get Address() : int;public function set Address(int); 

Description 

An Internet Protocol (IP) address. 

To convert System.Net JPAddress.Address to dotted-quad notation, use 
the System^Net JPAddress.ToString method. 
AddressFamily 
GetCredential 

[C#] public AddressFamily AddressFamily {get;} 

[C++] public: property AddressFamily get_AddressFamily(); 
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[VB] Public Readonly Property AddressFamily As AddressFamily 
[JScript] public function get AddressFamily() : AddressFamily; 

Description 

Specifies the address family of the IP address. 
Equals 

[C#] public override bool Equals(object comparand); 
[C++] public: bool Equals(Object* comparand); 

[VB] Overrides Public Function Equals(ByVal comparand As Object) As Boolean 
[JScript] public override function Equals(comparand : Object) : Boolean; 

Description 

Compares two IP addresses. 
Return Value: true if the two address are equal; otherwise, false . 

The System.Net.IPAddress.Equals(System.Object) method compares the 
current System.Net.IP Address instance with the comparand parameter and 
returns true if the two instance contain the same IP address. An 
System.Net.IF Address instance to compare to the current instance. 

GetHashCode 

[C#] pubHc override int GetHashCodeQ; 
[C++] public: int GetHashCodeQ; 

[VB] Overrides Public Function GetHashCodeQ As Integer 
[JScript] public override function GetHashCodeQ : int; 
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Description 

Returns a hash value for an IP address. 
Return Value: An integer hash value. 

The System.Net.IPAddress.GetHashCode method returns a hash code of 
the IP address. This value can be used as a key in hash tables. 

HostToNetworkOrder 

[C#] pubHc static short HostToNetworkOrder(short host); 

[C++] public: static short HostToNetworkOrder(short host); 

[VB] PubHc Shared Function HostToNetworkOrder(ByVal host As Short) As 

Short 

[JScript] public static function HostToNetworkOrder(host : Intl6) : Intl6; 
Description 

Converts a short value from host byte order to network byte order. 
Return Value: A short value expressed in network byte order. 

Different computers use different conventions for ordering the bytes within 
multi-byte integer values. Some computers put the most significant byte first 
(known as big-endian order) and others put the least-significant byte first (known 
as little-endian order). To enable computers that use different byte ordering, all 
integer values sent over the network are sent in network byte order. The number to 
convert expressed in host byte order. 

HostToNetworkOrder 
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[C#] public static int HostToNetworkOrder(int host); 

[C++] public: static int HostToNetworkOrder(int host); 

[ VB] Public Shared Function HostToNetworkOrder(By Val host As Integer) As 

Integer 

[ JScript] public static function HostToNetworkOrder(host : int) : int; 
Description 

Converts an integer value from host byte order to network byte order. 
Return Value: An integer value expressed in network byte order. 

Different computers use different conventions for ordering the bytes within 
multi-b)^e integer values. Some computers put the most significant byte first 
(known as big-endian order) and others put the least-significant byte first (known 
as little-endian order). To enable computers that use different byte ordering, all 
integer values sent over the network are sent in network byte order. The number to 
convert expressed in host byte order. 

HostToNetworkOrder 

[C#] public static long HostToNetworkOrder(long host); 

[C++] pubhc: static ^int64 HostToNetworkOrder( int64 host); 

[VB] Public Shared Function HostToNetworkOrder(ByVal host As Long) As 
Long 

[JScript] public static function HostToNetworkOrder(host : long) : long; Converts 
a value from host byte order to network byte order. 
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Description 

Converts a long value from host byte order to network byte order. 
Return Value: A long value expressed in network byte order. 

Different computers use different conventions for ordering the bytes within 
multi-byte integer values. Some computers put the most significant byte first 
(known as big-endian order) and others put the least-significant byte first (known 
as little-endian order). To enable computers that use different byte ordering, all 
integer values sent over the network are sent in network byte order. The number to 
convert expressed in host byte order. 

IsLoopback 

[C#] public static bool IsLoopback(IP Address address); 

[C++] public: static bool IsLoopback(IP Address"^ address); 

[VB] Public Shared Function IsLoopback(ByVal address As IP Address) As 

Boolean 

[JScript] public static function IsLoopback(address : IP Address) : Boolean; 
Description 

Indicates whether the specified IP address is the loopback address. 
Return Value: true \i address is the loopback address; otherwise false , 

The System.NetIP Address JsLoopback(System.NetlPAddress) method 
compares address to System.Net.IPAddress.Loopback and returns true if the 
two IP address are the same. An IP address. 

NetworkToHostOrder 
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[C#] public static short NetworkToHostOrder(short network); 

[C++] public: static short NetworkToHostOrder(short network); 

[VB] Public Shared Function NetworkToHostOrder(ByVal network As Short) As 

Short 

[JScript] public static function NetworkToHostOrder(network : Intl6) : Intl6; 
Description 

Converts a short value from network byte order to host byte order. 
Return Value: A short value expressed in host byte order. 

Different computers use different conventions for ordering the bytes within 
multi-byte integer values. Some computers put the most significant byte first 
(known as big-endian order) and others put the least-significant byte first (known 
as little-endian order). To enable computers that use different byte ordering, all 
integer values sent over the network are sent in network byte order. The number to 
convert expressed in network byte order. 

NetworkToHostOrder 

[C#] public static int NetworkToHostOrder(int network); 

[C++] public: static int NetworkToHostOrder(int network); 

[VB] Public Shared Function NetworkToHostOrder(ByVal network As Integer) 

As Integer 

[JScript] public static function NetworkToHostOrder(network : int) : int; 
Description 
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Converts an integer value from network byte order to host byte order. 
Return Value: An integer value expressed in host byte order. 

Different computers use different conventions for ordering the bytes within 
multi-byte integer values. Some computers put the most significant byte first 
(known as big-endian order) and others put the least-significant byte first (known 
as little-endian order). To enable computers that use different byte ordering, all 
integer values sent over the network are sent in network byte order. The number to 
convert expressed in network byte order. 

NetworkToHostOrder 

[C#] pubHc static long NetworkToHostOrder(long network); 

[C++] public: static ^int64 NetworkToHostOrder( ^int64 network); 

[VB] Public Shared Function NetworkToHostOrder(ByVal network As Long) As 
Long 

[JScript] public static function NetworkToHostOrder(network : long) : long; 
Converts a number from network byte order to host byte order. 

Description 

Converts a long value from network byte order to host byte order. 
Return Value: A long value expressed in host byte order. 

Different computers use different conventions for ordering the bytes within 
multi-byte integer values. Some computers put the most significant byte first 
(known as big-endian order) and others put the least-significant byte first (known 
as little-endian order). To enable computers that use different byte ordering, all 
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integer values sent over the network are sent in network byte order. The number to 
convert expressed in network byte order. 
Parse 

[C#] public static IP Address Parse(string ipString); 

[C++] pubHc: static IP Address* Parse(String* ipString); 

[VB] Public Shared Function Parse(ByVal ipString As String) As IPAddress 

[JScript] public static function Parse(ipString : String) : IPAddress; 

Description 

Converts an IP address string to an System.Net.IPAddress instance. 
Return Value: An System.NetJPAddress instance. 

The static System.Net.IPAddress.Parse(System.String) method creates 
an System.Net.IPAddress instance from an IP address expressed in dotted-quad 
("192.168.1.2") notation. A string containing an IP address in dotted-quad notation 
(for example, "192.168.1.2"). 

ToString 

[C#] public override string ToString(); 

[C++] pubhc: String* ToStringQ; 

[VB] Overrides Public Function ToStringQ As String 

[JScript] pubhc override function ToStringQ : String; 

Description 
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Converts an Internet address to standard dotted-quad format. 
Return Value: A string containing the IP address in dotted-quad format (for 

example, "192.168.1.2"). 

The System.NetJPAddress.ToString method converts the IP address 
stored in the System.NetJPAddressAddress property is converted to dotted- 
quad notation (for example, "192.168.1.2"). 

IPEndPoint class (System.Net) 

ToString 



Description 

Represents a network endpoint as an IP address and a port number. 

The System.Net JPEndPoint class contains the host and port information 
needed by an appHcation to connect to a service on a host. By combining the host's 
IP address and port number of a service, the System.Net.IPEndPoint class forms 
a connection point to a service. 

ToString 

[C#] public const int MaxPort; 
[C++] public: const int MaxPort; 
[VB] Public Const MaxPort As Integer 
[JScript] pubhc var MaxPort : int; 

Description 
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Specifies the maximum value that can be assigned to the 
System.Net.IPEndPoiiit.Port property. This field is read-only. 
ToString 

[C#] public const int MinPort; 
[C++] public: const int MinPort; 
[VB] PubHc Const MinPort As Integer 
[ JScript] pubUc var MinPort : int; 

Description 

Specifies the minimum value that can be assigned to the 
System.Net.IPEndPoint.Port property. This field is read-only. 
IPEndPoint 

Example Syntax: 
ToString 

[C#] public IPEndPoint(long address, int port); 

[C++] pubHc: IPEndPoint(_int64 address, int port); 

[VB] PubHc Sub New(ByVal address As Long, ByVal port As Integer) 

[JScript] public function IPEndPoint(address : long, port : int); Initializes a new 

instance of the System.Net.IPEndPoint class. 

Description 
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Initializes a new instance of the System.NetJPEndPoint class with the 
specified address and port number. The IP address of the Internet host. The port 
number associated with the address, or 0 to specify any available port. 

IPEndPoint 

Example Syntax: 

ToString 

[C#] public IPEndPoint(IP Address address, int port); 

[C++] public: IPEndPoint(IPAddress* address, int port); 

[VB] Public Sub New(ByVal address As IP Address, ByVal port As Integer) 

[JScript] public function IPEndPoint(address : IP Address, port : int); 



12 

13 Description 

Initializes a new instance of the System.Net.IPEndPomt class with the 
specified address and port number. The IP address of the Internet host. The port 
16 number associated with address 
Address 
ToString 



[C#] public IP Address Address {get; set;} 

[C++] public: property IPAddress* get_Address();public: _property void 

set_Address(IP Address*); 

[VB] Public Property Address As IPAddress 

[JScript] pubHc function get AddressQ : IPAddress;public function set 
Address(IP Address) ; 
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Description 

Gets or sets the IP address of the end point. 

AddressFamily 

ToString 

[C#] public override AddressFamily AddressFamily {get;} 
[C++] public: property virtual AddressFamily get AddressFamilyQ; 
[VB] Overrides Public ReadOnly Property AddressFamily As AddressFamily 
[JScript] public function get AddressFamilyQ : AddressFamily; 

Description 

Gets the Internet Protocol (IP) address family. 
Port 

ToString 
[C#] public int Port {get; set;} 

[C++] public: _property int get_Port();public: property void set_Port(int); 
[VB] Public Property Port As Integer 

[JScript] public function get PortQ : int;public function set Port(int); 
Description 

Gets or sets the TCP port number of the end point. 
Create 
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[C#] public override EndPoint Create(SocketAddress socketAddress); 

[C++] public: EndPoint* Create(SocketAddress* socketAddress); 

[VB] Overrides Public Function Create(ByVal socketAddress As SocketAddress) 

As EndPoint 

[JScript] public override function Create(socketAddress : SocketAddress) : 
EndPoint; 

Description 

Creates an end point from a socket address. 
Return Value: An System.Net.EndPomt instance using the specified socket. The 
network socket to use for the end point. 

Equals 

[C#] public override bool Equals(object comparand); 
[C++] public: bool Equals(Object* comparand); 

[VB] Overrides Public Function Equals(ByVal comparand As Object) As Boolean 
[JScript] pubhc override function Equals(comparand : Object) : Boolean; 
GetHashCode 

[C#] pubUc override int GetHashCodeQ; 
[C++] public: int GetHashCodeQ; 

[VB] Overrides Public Function GetHashCodeQ As Integer 
[JScript] public override function GetHashCodeQ : int; 
Serialize 
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[C#] public override SocketAddress SerializeQ; 

[C++] public: SocketAddress* SerializeQ; 

[VB] Overrides Public Function Serialize() As SocketAddress 

[JScript] public override function SerializeQ : SocketAddress; 



Description 

Serializes end point information into a System.Net.SocketAddress 

instance. 

10 Return Value: A Systein.Net.SocketAddress instance containing the socket 

1 1 address for the end point. 

12 ToString 

13 

14 [C#] public override string ToStringQ; 

15 [C++] public: String* ToStringQ; 

16 [VB] Overrides Public Function ToStringQ As String 

17 [JScript] public override function ToStringQ : String; 



Description 

Returns the IP address and port number for the specified end point. 
Return Value: A string containing the IP address, in dotted-quad notation, and the 
port number for the specified end point (for example, 192.168.1 .2:23). 

IPHostEntry class (System.Net) 

ToStiing 
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Description 

Provides a container class for Internet host address information. 
The System.Net.IPHostEiitry class associates a Domain Name System 
(DNS) host name with an array of aliases and an array of matching IP addresses. 
IPHostEntry 

Example Syntax: 
ToString 

[C#] public IPHostEntryO; 

[C++] public: IPHostEntryO; 

[VB] Public Sub New() 

[JScript] public function IPHostEntryO; 

AddressList 

ToString 

[C#] public IPAddress[] AddressList {get; set;} 

[C++] pubhc: _property IP Address* get_AddressListO;public: _property void 

set_AddressList(IPAddress*[]); 

[VB] Public Property AddressList As IP Address 0 

[JScript] public function get AddressListO : IPAddress[];public function set 
AddressList(IP Address []) ; 

Description 
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Gets or sets a list of IP addresses associated with a host. 
AUases 
ToString 

[C#] pubHc string[] AHases {get; set;} 

[C++] public: _property String* get_Aliases();public: _property void 
set_Aliases(String* _gc[]); 
[VB] Public Property Aliases As String () 

[JScript] public function get AHasesQ : String[];public function set 
10 Aliases(String[]); 

n 

12 Description 

Gets or sets a Hst of ahases associated with a host. 
HostName 
ToString 
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[C#] public string HostName {get; set;} 

[C++] pubhc: property String'^ get HostName();pubHc: ^property void 

setJHostName(String*); 

[VB] PubHc Property HostName As String 

[JScript] pubhc function get HostNameQ : String;public function set 
HostName(String); 

Description 

Gets or sets the DNS name of the host. 
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The System.Net.IPHostEiitry.HostName property contains the primary 
host name for a server. If the DNS entry for the server defines additional ahases, 
they will be available in the System.Net.IPHostEiitry.Aliases property. 

IWebProxy interface (System.Net) 

ToString 



Description 

Provides the base interface for implementation of proxy access for the 
System.Net.WebRequest class. 

The System.NetJWebProxy interface provides the methods and properties 
required by the Systein.Net.WebRequest class to access proxy servers. 

Credentials 

ToString 

[C#] ICredentials Credentials {get; set;} 

[C++] ICredentials* get_Credentials();void set_Credentials(ICredentials*); 
[VB] Property Credentials As ICredentials 

[JScript] abstract function get CredentialsQ : ICredentials ;public abstract function 
set Credentials(ICredentials); 

Description 

The credentials to submit to the proxy server for authentication. 
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The System.NeUWebProxy.Credentials property is an 
System.Net JCredentials instance containing the authorization credentials to send 
to the proxy server in response to an HTTP 407 (proxy authorization) status code. 

GetProxy 

[C#] Uri GetProxy(Uri destination); 

[C++] Uri* GetProxy(Uri* destination); 

[VB] Function GetProxy(ByVal destination As Uri) As Uri 

[JScript] function GetProxy(destination : Uri) : Uri; 

Description 

Returns the URI of a proxy. 
Return Value: A System.Uri containing the URI of the proxy used to contact 
destination . 

The System.Net JWebProxy.GetProxy(System.Uri) method returns the 
URI of the proxy server that handles requests to the Internet resource specified in 
the destination parameter. A System.Uri specifying the requested Intemet 
resource. 

IsBypassed 

[C#] bool IsBypassed(Uri host); 
[C++] bool IsBypassed(Uri* host); 

[VB] Function IsBypassed(ByVal host As Uri) As Boolean 
[JScript] function IsBypassed(host : Uri) : Boolean; 
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Description 

Indicates that the proxy should not be used for the specified host. 
Return Value: true if the proxy server should not be used for host ; otherwise, 
false . 

The Systein.Net.IWebProxy.IsBypassed(System.Uri) method indicates 
whether to use the proxy server to access the host specified in the host parameter. 
If System.Net.IWebProxy.IsBypassed(System.Uri) is true , the proxy is not 
used to contact the host and the request is passed directly to the server. The 
System.Uri of the host to check for proxy use. 

IWebRequestCreate interface (System.Net) 

IsBypassed 



Description 

Provides the base interface for creating System.Net. WebRequest 
instances. 

The System.Net.IWebRequestCreate interface defines the method that 
System.Net.WebRequest descendants must use to register with the 
System.Net.WebRequest.Create(System.Uri,System.Booleaii) method. 

Create 

[C#] WebRequest Create(Uri uri); 

[C-H-] WebRequest* Create(Uri* uri); 

[VB] Function Create(ByVal uri As Uri) As WebRequest 
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[JScript] function Create(uri : Uri) : WebRequest; 

Description 

Creates a System.Net.WebRequest instance. 
Return Value: A System.Net. WebRequest instance. 

The System.Net JWebRequestCreate.Create(System.Uri) method must 
retum an initialized instance of the System-Net. WebRequest descendant capable 
of perfomiing a standard request/response transaction for the protocol without 
needing any protocol-specific fields modified. The uniform resource identifier 
(URI) of the Web resource. 

NetworkAccess enumeration (System.Net) 

Create 
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Description 

Specifies network access permissions. 

The System.Net.NetworkAccess enumeration is used with the 
System.NetWebPermission and System.NetSocketPermission classes. 
Create 

[C#] public const NetworkAccess Accept; 
[C++] public: const NetworkAccess Accept; 
[VB] Public Const Accept As NetworkAccess 
[JScript] public var Accept : NetworkAccess; 
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Description 

Indicates that the appHcation is allowed to accept connections from the 
Internet on a local resource. 
Create 

[C#] public const NetworkAccess Connect; 
[C+-f ] pubUc: const NetworkAccess Connect; 
[VB] Public Const Connect As NetworkAccess 
[JScript] public var Connect : NetworkAccess; 

Description 

Indicates that the application is allowed to connect to specific Internet 
resources. 

NetworkCredential class (System.Net) 
ToString 

Description 

Provides credentials for password-based authentication schemes such as 
basic, digest, NTLM, and Kerberos authentication. 

The System.Net^NetworkCredential class is a base class that supplies 
credentials in password-based authentication schemes such as basic^ digest, 
NTLM, and Kerberos. Classes that implement the System.Net ICredentials 
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interface, such as the System.Net.CredentialCache class, return 
System^Net-NetworkCredential instances. 

NetworkCredential 

Example Syntax: 

ToString 

[C#] pubHc NetworkCredentialO; 

[C++] public: NetworkCredentialO; 

[VB] Public SubNewO 

[ JScript] pubUc function NetworkCredentialO; 

NetworkCredential 

Example Syntax: 

ToString 

[C#] public NetworkCredential(string userName, string password); 
[C++] public: NetworkCredential(String* userName, String"*" password); 
[ VB] Public Sub New(ByVal userName As String, ByVal password As String) 
[JScript] public function NetworkCredential(userName : String, password : 
String); Initializes anew instance of the System.Net.NetworkCredential class. 

Description 

Initializes a new instance of the System.Net.NetworkCredential class with 
the specified user name and password. 

The constructor initializes a System.Net.NetworkCredential instance is 
initialized with the System.Net.NetworkCredentiaKUserName property set to 
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userName and the System.Net.NetworkCredential.Password property set to 
password . The user name associated with the credentials. The password for the 
user name associated with the credentials. 
NetworkCredential 

Example Syntax: 
ToString 

[C#] pubHc NetworkCredential(string userName, string password, string domain); 
[C++] pubHc: NetworkCredential(String* userName, String* password, String* 
domain); 

[VB] PubUc Sub New(ByVal userName As String, ByVal password As String, 
ByVal domain As String) 

[JScript] pubhc function NetworkCredential(userName : String, password : String, 
domain : String); 

Description 

InitiaHzes a new instance of the System.Net.NetworkCredential class with 
the specified user name, password, and domain. 

The constructor initializes a System.Net.NetworkCredential instance with 
the System.Net.NetworkCredential.UserName property set to userName , the 
System.Net.NetworkCredeiitiaI.Password property set to password , and the 
System.Net.NetworkCredential.Domaiii property set to domain . The user name 
associated with the credentials. The password for the user name associated with 
the credentials. The domain associated with these credentials. 

Domain 
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ToString 

[C#] public string Domain {get; set;} 

[C++] public: _property String* get_Domain();public: _property void 

set_Domain(String*) ; 

[VB] Public Property Domain As String 

[JScript] public function get DomainQ : String;public function set Domain(String); 
Description 

Gets or sets the domain or machine name that verifies the credentials. 

The System.Net.NetworkCredentiaLDomaiii property specifies the 
domain or realm to which the user name belongs. Typically, this is the host 
machine name where the appUcation runs or user domain for the currently logged 

in user. 

Password 
ToString 

[C#] pubhc string Password {get; set;} 

[C++] pubUc: _property String^^ get_Password();pubUc: property void 

set_Password(String*); 

[VB] Public Property Password As String 

[JScript] public function get PasswordQ : String;public function set 
Password(String); 

Description 
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Gets or sets the password for the user name associated with the credentials. 

UserName 

ToString 

[C#] pubHc string UserName {get; set;} 

[C++] public: property String* get_UserName();public: property void 

set_UserName(String*); 

[VB] Public Property UserName As String 

[ JScript] public function get UserNameQ : String;public function set 
UserName(String) ; 

Description 

Gets or sets the user name associated with the credentials. 
GetCredential 

[C#] public NetworkCredential GetCredential(Uri uri, string authType); 

[C++] public: sealed NetworkCredential* GetCredential(Uri* uri, String* 

authType); 

[VB] NotOverridable Public Function GetCredential(ByVal uri As Uri, ByVal 
authType As String) As NetworkCredential 

[JScript] public function GetCredential(uri : Uri, authType : String) : 
NetworkCredential; 

Description 
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1 1 1 Returns an instance of the System.Net.NetworkCredeiitial class for the 

2 II specified URI and authentication type. 

Return Value: A System.Net.NetworkCredential instance. The URI that the 
client is providing authentication for. The type of authentication requested as 
5 1 1 defined in the System.Net.IAuthenticationModule.AutheiiticationType 

6 II property. 

ProtocolViolationException class (System.Net) 

ToString 

10 I 

11 11 Description 

12 1 1 The exception that is thrown when an error is made while using a network 

13 II protocol. 

14 1 1 A System.Net.ProtocolViolationException is thrown by descendants of 

15 11 System.Net.WebRequest and System.Net.WebResponse to indicate an error 
16 II using the underlying protocol. For example, the System.Net.HttpWebRequest 
17 II and System.Net.HttpWebResponse classes throw a 
,8 II System.Net.ProtocolViolationExceptioii to indicate an error using HTTP. 
19 II ProtocolViolationException 

20 Example Syntax: 

21 ToString 



22 



23 [C#] public ProtocolViolationExceptionQ; 

24 [C++] public: ProtocolViolationExceptionQ; 

25 [VB] Public Sub New() 
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[JScript] public function Protocol ViolationExceptionQ; Initializes a new instance 
of the System.Net.ProtocolViolationException class. 

Description 

Initializes anew instance of the System.Net.ProtocolViolationExceptioii 

class. 

The default constructor initializes a new instance of the 
System.Net.ProtocolViolationExceptioii class with all properties set to null . 
ProtocolVioIationException 
Example Syntax: 
ToString 

[C#] public ProtocolViolationException(string message); 
[C++] public: ProtocolViolationException(String* message); 
[VB] Public Sub New(ByVal message As String) 

[JScript] public function ProtocolViolationException(message : String); 
Description 

Initializes a new instance of the System.Net.FrotocolViolationException 

class with the specified message. 

The System.Net.ProtocolViolationException.#ctor constructor initializes 
anew instance of the System.Net.ProtocolViolationException class with the 
System.Exceptioii.Message property set to the value of the message parameter. 
The error message string. 

ProtocolVioIationException 
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Example Syntax: 
ToString 

[C#] protected ProtocolViolationException(SerializationInfo seiializationlnfo, 
StreamingContext streamingContext); 

[C++] protected: ProtocolViolationException(SerializationInfo* serializationlnfo, 
StreamingContext streamingContext); 

[VB] Protected Sub New(ByVal serializationlnfo As Serializationlnfo, ByVal 
StreamingContext As StreamingContext) 

[JScript] protected function ProtocolViolationException(serializationInfo : 
Serializationlnfo, streamingContext : StreamingContext); 

HelpLink 

HResult 

InnerException 

Message 

Source 

StackTrace 

TargetSite 

ISerializable.GetObjectData 

[C#] void ISerializable.GetObjectData(SerializationInfo serializationlnfo, 
StreamingContext streamingContext) ; 

[C++] void ISerializable::GetObjectData(SerializationInfo* serializationlnfo, 
StreamingContext streamingContext) ; 

[VB] Sub GetObjectData(ByVal serializationlnfo As Serializationlnfo, ByVal 
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streamingContext As StreamingContext) Implements ISerializable.GetObjectData 
[JScript] function ISerializable.GetObjectData(serializationInfo : Serializationlnfo, 
StreamingContext : StreamingContext); 

ServicePoint class (System.Net) 

ToString 



Description 

Provides connection management for HTTP connections. 

The System.Net.ServicePoiiit class handles connections to an Internet 
resource based on the host information passed in the resource's URI. The initial 
connection to the resource determines the information the 
System.Net.ServicePoint maintains, which is then shared by all subsequent 
requests to that resource. 

Address 

ToString 

[C#] pubUc Uri Address {get;} 
[C++] pubhc: __property Uri* get_Address(); 
[VB] PubHc Readonly Property Address As Uri 
[JScript] public function get Address() : Uri; 

Description 

Gets the URI of the System.Net.ServicePoint . 

Certificate 
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ToString 

[C#] public X509Certificate Certificate {get;} 
[C++] public: __property X509Certificate* get_Certificate(); 
[VB] Public Readonly Property Certificate As X509Certificate 
[JScript] public function get CertificateQ : X509Certificate; 

Description 

Gets the certificate received for this System.Net.ServicePoint . 
Although a System.Net.ServicePoiiit can make multiple connections to an 
Internet resource, it can maintain only one certificate. 
ClientCertificate 
ToString 

[C#] public X509Certificate ClientCertificate {get;} 

[C++] public: __property X509Certificate* get_ClientCertificate(); 

[VB] Public Readonly Property ClientCertificate As X509Certificate 

[JScript] public function get CMentCertificate() : X509Certificate; Gets the Client 

Certificate sent by us to the Server. 

ConnectionLimit 

ToString 

[C#] public int ConnectionLimit {get; set;} 

[C++] public: property int get_ConnectionLimit();public: property void 
set ConnectionLimit(int); 
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[VB] Public Property ConnectionLimit As Integer 

[JScript] public function get ConnectionLimitQ : int;public function set 

ConnectionLimit(int); 

Description 

Gets or sets the maximum number of connections allowed on this 
System.Net.ServicePoiiit . 

The System.Net.ServicePoint.ConnectionLimit property sets the 
maximum number of connections that the System.Net.ServicePoint can make to 
an Internet resource. The value of the System.Net.ServicePoint.ConnectionLimit 
property is set to the value of the 

System.Net.ServicePointManager.DefaultConnectionLimit property when the 
System.Net.ServicePoint is created; subsequent changes to 
System.Net.ServicePoiiitManager.DefaultCoiinectionLimit have no effect on 

existing System.Net.ServicePoint instances. 
ConnectionName 
ToString 

[C#] public string ConnectionName {get;} 
[C++] public: _property String* get_ConnectionName(); 
[VB] Public Readonly Property ConnectionName As String 
[JScript] pubhc function get ConnectionNameQ : String; 

Description 
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Gets the connection group name established by the 
System.Net.WebRequest that created the connection. 

The System-NetServicePoint^ConnectionName property contains the 

connection group assigned to the 

System.Net.WebRequest.ConiiectionGroupName property of the 
System.Net.WebRequest that initiated the connection provided by this 
System.Net.ServicePoiiit . If the System.NetServicePointConnectionName 
property is set, only System.Net.WebRequest instances with the same 
System.NetWebRequest.ConnectionGroupName can use this 
System.NetServicePoint . 

CurrentConnections 

ToString 

[C#] public int CurrentConnections {get;} 

[C++] public: property int get CurrentConnectionsQ; 

[VB] Public Readonly Property CurrentConnections As Integer 
[JScript] public function get CurrentConnections() : int; 

Description 

Gets the number of connections associated with this 
System.Net.ServicePoint . 

The System^NetServicePointCurrentConnections property contains the 

number of active Intemet connections associated with this 
System.Net.ServicePoint . The value of 
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System.Net.ServicePoiiit.CurrentConnections cannot exceed that of 
System.Net.ServicePoint.ConnectioiiLimit . 

IdleSince 
ToString 

[C#] public DateTime IdleSince {get;} 
[C++] public: property DateTime get ldleSinceQ; 
[VB] Public Readonly Property IdleSince As DateTime 
[JScript] public function get IdleSinceQ : DateTime; 

Description 

Gets the date and time that the System.Net.ServicePoint was last accessed. 

The System.Net.ServicePoint.IdleSince property records the last date and 
time at which a service point was accessed. When the difference between the 
current time and System.Net.ServicePoiiit.IdleSince exceeds the value of 
System.Net.ServicePoint.MaxIdleTime , the Systein.Net.ServicePoint is 
available for recycling to another connection. 

MaxIdleTime 

ToString 

[C#] pubHc int MaxIdleTime {get; set;} 

[C++] public: _property int get_MaxIdleTimeO;public: property void 
set_MaxIdleTime(int); 

[VB] PubUc Property MaxIdleTime As Integer 

[JScript] public function get MaxIdleTimeQ : int;public function set 
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MaxIdleTime(mt); 
Description 

Gets or sets the maximum idle time for the System.Net.ServicePoint . 

The System.Net.ServicePoint.MaxIdleTime property contains the length 
of time, in milliseconds, that the System-NetServicePoint is allowed to maintain 
an idle connection to an Internet resource before it is recycled for use in another 
connection. 

ProtocolVersion 

ToString 

[C#] public virtual Version ProtocolVersion {get;} 

[C++] public: property virtual Version* get_ProtocolVersion(); 

[VB] Overridable PubHc ReadOnly Property ProtocolVersion As Version 
[JScript] public function get ProtocolVersionQ : Version; 

Description 

Gets the version of the HTTP protocol that the System.Net.ServicePoint 

uses. 

SupportsPipelining 
ToString 

[C#] public bool SupportsPipeUning {get;} 

[C++] public: property bool get_SupportsPipelining(); 

[VB] PubHc Readonly Property SupportsPipelining As Boolean 
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[JScript] public function get SupportsPipeliningO : Boolean; 
Description 

Indicates whether the System.Net.ServicePoint supports pipelined 
connections. 

GetHashCode 

[C#] public override int GetHashCodeQ; 
[C++] public: int GetHashCodeQ; 

[VB] Overrides Public Function GetHashCodeQ As Integer 
[JScript] public override function GetHashCodeQ : int; 

Description 

Gets the hash code for the System.Net.ServicePoint . 
Return Value: The hash code for the System.Net.ServicePoint . 

The hash code for System.Net.ServicePoint A and B is the same if 

A.Equals(B) is true . 

ServicePointManager class (System.Net) 
ToString 



Description 

Manages the collection of System.Net.ServicePoint instances. 
System.Net.ServicePointManager is a static class used to create, 
maintain, and delete instances of the System.Net.ServicePoiiit class. 
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ToString 

[C#] public const int DefaultNonPersistentConnectionLimit; 
[C++] public: const int DefaultNonPersistentConnectionLimit; 
[VB] Public Const DefaultNonPersistentConnectionLimit As Integer 
[JScript] public var DefaultNonPersistentConnectionLimit : int; 

Description 

The default number of nonpersistent connections allowed on a 
System.Net.ServicePoint connected to an HTTP/1.1 server. 
ToString 

[C#] public const int DefaultPersistentConnectionLimit; 
[C++] public: const int DefaultPersistentConnectionLimit; 
[VB] Public Const DefaultPersistentConnectionLimit As Integer 
[JScript] public var DefaultPersistentConnectionLimit : int; 

Description 

The default number of persistent connections allowed on a 
System.Net.ServicePoint connected to an HTTP/1.0 server. 
CertificatePolicy 
ToString 

[C#] public static ICertificatePolicy CertificatePoUcy {get; set;} 

[C++] public: _property static ICertificatePolicy* get_CertificatePolicy();public: 
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property static void set_CertificatePolicy(ICertificatePolicy*); 
[VB] Public Shared Property CertificatePolicy As ICertificatePolicy 
[JScript] public static function get CertificatePolicy() : ICertificatePolicy;public 
static function set CertificatePolicy(ICertificatePolicy); 

Description 

Gets or sets policy for server certificates. 

When the System.Net.SenicePointManager.CertificatePolicy property is 
set to an System.Net.ICertificatePolicy interface instance, the 
System.Net.ServicePointManager uses the certifiate pohcy defined in that 
instance instead of the default certificate policy. 

DefauhConnectionLimit 

ToString 

[C#] public static int DefauhConnectionLimit {get; set;} 

[C++] public: _property static int get_DefaultConnectionLimitO;pubHc: 

property static void set_DefauhConnectionLimit(int); 

[VB] Pubhc Shared Property DefauhConnectionLimit As Integer 

[JScript] pubhc static function get DefauhConnectionLimit() : int;public static 

function set DefaultConnectionLimit(int); 

Description 

The maximum number of concurrent connections aUowed by a 
System.Net.ServicePoint instance. 
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TheSystem.Net.ServicePointManager.DefaultConnectionLimit 
property sets the default maximum number of concurrent connections that the 
System.Net.ServicePointManager assigns to the 
System.Net.ServicePomt.ConnectionLiiiiit property when creating 
System.Net.ServicePoint instances. 

MaxServicePointldleTime 

ToString 

[C#] public static int MaxServicePointldleTime {get; set;} 

[C++] public: _property static int get_MaxServicePointIdleTime();public: 

property static void set_MaxServicePointIdleTime(int); 

[VB] Public Shared Property MaxServicePointldleTime As Integer 

[JScript] public static function get MaxServicePointldleTimeQ : int;public static 

function set MaxServicePointIdleTime(int); 

Description 

Gets or sets the maximum idle time of a System.Net.ServicePoint 

instance. 

TheSystem.Net.ServicePointManager.MaxServicePointIdleTime 

property sets the maximum idle time that the System.Net.ServicePointManager 
assigns to the System.Net.ServicePoiiit.MaxIdleTime property when creating 
Systein.Net.ServicePoint instances. Changes to this value will affect only 
System.Net.ServicePoint instances that are initialized after the value is changed. 

MaxServicePoints 

ToString 
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[C#] public static int MaxServicePoints {get; set;} 

[C++] public: _property static int get_MaxServicePoints();public: _property 

static void set_MaxServicePoints(int); 

[VB] Public Shared Property MaxServicePoints As Integer 

[JScript] public static function get MaxServicePointsQ : int;public static function 

set MaxServicePoints(int); 

Description 

Gets or sets the maximum number of System.Net.ServicePoiiit instances 
to maintain at any time. 

When you reduce the 
System.Net.ServicePomtManager.MaxServicePoints property below the 
number of System.Net.ServicePoint instances currently in existence, the 
System.Net.ServicePointManager deletes the Systein.Net.ServicePoiiit 
instances with the longest idle times. If the number of System.Net.ServicePoint 
instances with active connections is greater than the value of 
System.Net.ServicePoiiitManager.MaxServicePoiiits , the 
System.Net.ServicePoiiitManager will delete the System.Net.ServicePoint 
instances as they become idle. 

FindServicePoint 

[C#] public static ServicePoint FindServicePoint(Uri address); 
[C++] public: static ServicePoint* FindServicePoint(Uri* address); 
[VB] Public Shared Function FindServicePoint(ByVal address As Uri) As 
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ServicePoint 

[JScript] public static function FindServicePoint(address : Uri) : ServicePoint; 
Finds an existing System.Net.ServicePoint or creates a new 
System.Net.ServicePoint to manage communication for this request. 

Description 

Finds an existing System.Net.ServicePoint or creates a new 
System.Net.ServicePoint to manage communications with the specified 
System.Uri . 

Return Value: The System.Net.ServicePoint that manages communications for 
the request. 

TheSystem.Net.ServicePointManager.FindServicePoint(System.Uri) 
method returns the System.Net.ServicePoint instance associated with the 
specified Internet host name. If no System.Net.ServicePoint exists for that host, 
the System.Net.ServicePointManager creates one. The System.Uri of the 

Internet resource to contact. 
FindServicePoint 

[C#] pubUc static ServicePoint FindServicePoint(string uriString, IWebProxy 
proxy); 

[C++] public: static ServicePoint* FindServicePoint(String* uriString, 
IWebProxy* proxy); 

[VB] Public Shared Function FindServicePoint(ByVal uriString As String, ByVal 
proxy As IWebProxy) As ServicePoint 

[JScript] public static function FindServicePoint(uriString : String, proxy : 
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IWebProxy) : ServicePoint; Finds an existing System.Net.ServicePoiiit or creates 
a new System.Net.ServicePoint to manage conmiunication for this request. 

Description 

Finds an existing System.Net.ServicePoiiit or creates a new 
System.Net.ServicePoint to manage communications with the specified URI. 
Return Value: The System.Net.ServicePoiiit that manages communications for 
the request. 

TheSystem.Net.ServicePointManager.FindServicePoint(System.Uri) 

method returns the System.Net.ServicePoiiit instance associated with the 
specified Internet host name. If no System.Net.ServicePoint exists for that host, 
the System.Net.ServicePointManager creates one. The URI of the Internet 
resource to be contacted. Proxy data for this request. 
FindServicePoint 

[C#] pubHc static ServicePoint FindServicePoint(Uri address, IWebProxy proxy); 
[C++] pubHc: static ServicePoint* FindServicePoint(Uri* address, IWebProxy* 
proxy); 

[VB] Public Shared Function FindServicePoint(ByVal address As Uri, ByVal 
proxy As IWebProxy) As ServicePoint 

[JScript] public static function FindServicePoint(address : Uri, proxy : 
IWebProxy) : ServicePoint; 

Description 
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Finds an existing System.Net.ServicePoint or creates a new 
System.Net,ServicePoint to manage communications with the specified 
System.Uri instance. 

Return Value: The System.Net.ServicePoint that manages communications for 
the request. 

The System.Net.ServicePomtManager.FindServicePoiiit(System.Uri) 

method returns the System.Net.ServicePoiiit instance associated with the 
specified Intemet host name. If no System.Net.ServicePoint exists for that host, 
the System.Net.ServicePointManager creates one. A System.Uri instance 
containing the address of the Intemet resource to contact. Proxy data for this 

11 request. 

12 SocketAddress class (System.Net) 

13 ToString 



10 



14 



15 
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Description 

Identifies a socket address. 
SocketAddress 
Example Syntax: 
ToString 

[C#] public SocketAddress(AddressFamily family); 

[C++] public: SocketAddress(AddressFamily family); 

[VB] Public Sub New(ByVal family As AddressFamily) 

[JScript] public function SocketAddress(family : AddressFamily); Initializes a 
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new instance of the System.Net.SocketAddress class. 
Description 

Initializes a new instance of the System.NetSocket Address class for the 
given address family. 
SocketAddress 
Example Syntax: 
ToString 

[C#] public SocketAddress(AddressFaniily family, int size); 

[C++] pubUc: SocketAddress(AddressFamily family, int size); 

[VB] Public Sub New(ByVal family As AddressFamily, ByVal size As Integer) 

[JScript] public function SocketAddress(family : AddressFamily, size : int); 

Description 

Family 
ToString 

[C#] public AddressFamily Family {get;} 

[C++] public: property AddressFamily get_Family(); 

[VB] Public Readonly Property Family As AddressFamily 
[JScript] public function get FamilyQ : AddressFamily; 

Description 
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Item 
ToString 

[C#] public byte this[int offset] {get; set;} 

[C++] public: _property unsigned char get_Item(int offset) ;public: _property 
void set_Item(int offset, unsigned char); 

[VB] Public Default Property Item(ByVal offset As Integer) As Byte 
[JScript] retumValue = 

SocketAddressObject.Item(offset);SocketAddressObject.Item(offset) = 
retumValue; 

Description 

Size 

ToString 

[C#] public int Size {get;} 

[C++] public: property int get SizeQ; 

[VB] Public Readonly Property Size As Integer 

[JScript] public function get SizeQ : int; 

Description 

Equals 
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[C#] public override bool Equals(object comparand); 
[C++] public: bool Equals(Object* comparand); 

[VB] Overrides Public Function Equals(ByVal comparand As Object) As Boolean 
[JScript] public override function Equals(comparand : Object) : Boolean; 
GetHashCode 

[C#] public override int GetHashCode(); 
[C++] public: int GetHashCodeQ; 

[VB] Overrides Public Function GetHashCodeQ As Integer 
[JScript] public override function GetHashCodeQ : int; 
ToString 

[C#] public override string ToStringQ; 
[C++] public: String* ToStringQ; 
[VB] Overrides Public Function ToStringQ As String 
[JScript] public override function ToStringQ : String; 
SocketPermission class (System.Net) 
ToString 



Description 

Controls rights to make or accept connections on a transport address. 
ToString 
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[C#] public const int AUPorts; 
[C++] public: const int AUPorts; 
[ VB] Public Const AUPorts As Integer 
[ JScript] public var AUPorts : int; 

Description 

Defines a constant representing all ports. 

SocketPermission 

Example Syntax: 

ToString 

[C#] public SocketPermission(PermissionState state); 
[C++] public: SocketPermission(PermissionState state); 
[VB] Public Sub New(ByVal state As PermissionState) 

[JScript] public function SocketPermission(state : PermissionState); Initializes a 
new instance of the System.Net.SocketPermission class. 

Description 

Initializes a new instance of the System.Net.SocketPermission class that 
passes all demands or fails all demands. 

If the System.Net.SocketPermission instance was created with the 
Unrestricted value from System.Security.Permissions.PermissionState then the 
System.Net.SocketPermission instance will pass all demands. Any other value 
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for state will result in a System.Net.SocketPermission instance that will fail all 
demands. One of the System.Security.Permissions.PeriiiissionState values. 

SocketPermission 

Example Syntax: 

ToString 

[C#] public SocketPermission(NetworkAccess access, TransportType transport, 
string hostName, int portNumber); 

[C++] puWic: SocketPermission(NetworkAccess access, TransportType transport, 
String* hostName, int portNumber); 

[VB] Public Sub New(ByVal access As NetworkAccess, ByVal transport As 
TransportType, ByVal hostName As String, ByVal portNumber As Integer) 
[JScript] public function SocketPermission(access : NetworkAccess, transport : 
TransportType, hostName : String, portNumber : int); 

Description 

Initializes a new instance of the System.Net.SocketPermission class for 
the given transport address with the specified permission. One of the 
System.Net.NetworkAccess values. One of the System.Net.TransportType 
values. The host name for the transport address. The port number for the transport 
address. 

AcceptList 

ToString 

[C#] public Enumerator AcceptList {get;} 
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[C++] public: property lEnumerator* get_AcceptList(); 
[VB] Public Readonly Property AcceptList As lEnumerator 
[JScript] public function get AcceptListQ : lEnumerator; 

Description 

Gets a list of System.Net.EndpointPermissioii instances identifying the 
endpoints that can be accepted under this permission instance. 
ConnectList 
ToString 

[C#] public lEnumerator ConnectList {get;} 
[C++] public: property lEnumerator* get_ConnectList(); 
[VB] Public Readonly Property ConnectList As lEnumerator 
[JScript] public function get ConnectListQ : lEnumerator; 

Description 

Gets a list of Systein.Net.EndpoiiitPermission instances identifying the 
endpoints that can be connected to under this permission instance. 
AddPermission 

[C#] public void AddPermission(NetworkAccess access, TransportType transport, 
string hostName, int portNumber); 

[C++] public: void AddPermission(NetworkAccess access, TransportType 
transport, String* hostName, int portNumber); 

[VB] Public Sub AddPermission(ByVal access As NetworkAccess, ByVal 
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transport As TransportType, ByVal hostName As String, ByVal portNumber As 
Integer) 

[JScript] public function AddPermission(access : NetworkAccess, transport : 
TransportType, hostName : String, portNumber : int); 

Description 

Adds a permission to the set of permissions for a transport address. 

Permissions are checked with a logical OR operation. One of the 
System.Net.NetworkAccess values. One of the System.Net.TransportType 
values. The host name for the transport address. The port number for the transport 
address. 

Copy 

[C#] public override IPermission Copy(); 

[C++] pubHc: IPermission* Copy(); 

[VB] Overrides Public Function CopyQ As IPermission 

[JScript] public override function Copy() : IPermission; 

Description 

Creates a copy of a System.Net.SocketPermission instance. 
Return Value: A new instance of the System.Net.SocketPermission class that is a 
copy of the current instance. 

FromXml 

[C#] public override void FromXml(SecurityElement securityElement); 
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[C++] public: voidFromXinKSecurityElement* securityElement); 
[VB] Overrides Public Sub FromXml(ByVal securityElement As 
SecurityElement) 

[JScript] public override function FromXml(securityElement : SecurityElement); 
Description 

Reconstructs a System-Net-SocketPermission instance for an XML 
encoding. 
The 

System.Net.SocketPermission.FromXml(System.Security.SecurityElement) 

method reconstructs a System.Net.SocketPermission instance from an XML 
encoding defined by the System.Security.SecurityElement class. The XML 
encoding used to reconstruct the System.Net.SocketPermission instance. 



14 Intersect 
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[C#] pubHc override IPermission Intersect(IPermission target); 

[C++] public: IPermission* Intersect(IPermission=*= target); 

[VB] Overrides Public Function Intersect(ByVal target As IPermission) As 

IPermission 

[JScript] public override function Intersect(target : IPermission) : IPermission; 

Description 

Returns the logical intersection between two 
System.Net.SocketPermission instances. 

Return Value: The System.Net.SocketPermission instance that represents the 
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intersection of two System.Net.SocketPermission instances. The 
System.Net.SocketPermission instance to combine with the current instance. 
IsSubsetOf 

[C#] public override bool IsSubsetOf(IPermission target); 
[C++] pubhc: bool IsSubsetOf(IPermission* target); 

[VB] Overrides Public Function IsSubsetOf(ByVal target As IPermission) As 
Boolean 

[JScript] public override function IsSubsetOf(target : IPermission) : Boolean; 
Description 

Compares two System.Net.SocketPermission instances. 
Return Value: false \i target is null ; otherwise, an exception is thrown. 

The System.Net.SocketPermission class does not support the 
System.Net.SocketPermission.IsSubsetOf(Systein.Security .IPermission) 

method. The second System.Net.SocketPermission instance to compare. 

IsUnrestricted 

[C#] pubUc bool IsUnrestrictedO; 

[C++] pubHc: ^sealed bool IsUnrestricted(); 

[VB] NotOverridable Public Function IsUnrestrictedQ As Boolean 
[JScript] public function IsUnrestrictedQ : Boolean; 

Description 
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Checks the overall permission state of the object. 
Return Value: true if the Systein.Net.SocketPermission instance was created 
with the Unrestricted value from System.Security.Permissions.PermissionState 
; otherwise, false . 

ToXml 

[C#] public override SecurityElement ToXmlQ; 

[C++] public: SecurityElement* ToXmlQ; 

[VB] Overrides Public Function ToXml() As SecurityElement 

[JScript] public override function ToXmlQ : SecurityElement; 

Description 

Creates an XML encoding of a System.Net.SocketPermissioii instance and 
its current state. 

Return Value: A System.Security.SecurityElement instance containing an XML- 
encoded representation of the System.Net.SocketPermission instance, including 

state information. 

The System.Net.SocketPermission.ToXml method creates a 
System.Security.SecurityElemeiit instance to encode a representation of the 
System.Net.SocketPermissioii instance, including state information, in XML. 

Union 

[C#] pubHc override IPermission Umon(IPermission target); 

[C++] public: IPermission* Union(IPermission* target); 

[VB] Overrides Public Function Union(ByVal target As IPermission) As 
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IPermission 

[JScript] public override function Union(target : IPermission) : IPermission; 

Description 

Returns the logical union between two System.Net.SocketPermissioii 

instances. 

Return Value: The System.Net.SocketPermission instance that represents the 
union of two System.Net.SocketPerinission instances. The 
System.Net.SocketPermissioii instance to combine with the current instance. 

SocketPermissionAttribute class (System.Net) 

Union 



Description 

Enables security actions for System.Net.SocketPermission to be applied to 
code using declarative security. This class cannot be inherited. 
SocketPermissionAttribute 
Example Syntax: 
Union 

[C#] public SocketPermissionAttribute(SecurityAction action); 

[C++] public: SocketPermissionAttribute(SecurityAction action); 

[VB] Public Sub New(ByVal action As SecurityAction) 

[JScript] public function SocketPermissionAttribute(action : SecurityAction); 
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Description 

Initializes a new instance of the System.Net.SocketPermission Attribute 
class with the specified System.Security.Permissions^SecurityAction value. One 
of the System.Security.Permissions.Security Action values. 

Access 

Union 

[C#] public string Access {get; set;} 

[C++] pubHc: _property String* get__Access();pubhc: _property void 

set__Access(String*); 

[VB] Public Property Access As String 

[JScript] public function get AccessQ : String;public function set Access(String); 
Description 

Gets or sets the network access method allowed by this permission 
instance. 

Action 

Host 

Union 



Description 

The DNS host name or IP address associated with this permission instance. 
Port 
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Union 



[C#] public string Port {get; set;} 

[C++] public: _property String* get_Port();public: _property void 
set_Port(String*); 

[VB] Public Property Port As String 

[JScript] public function get PortQ : String;public function set Port(String); 
Description 

Gets or sets the transport type associated with this permission instance. 

Transport 

Union 

[C#] public string Transport {get; set;} 

[C++] public: _property String* get_Transport();public: _property void 

set_Transport(String*); 

[VB] Public Property Transport As String 

[JScript] public function get TransportQ : String;public function set 
Transport(String); 

Description 

Gets or sets the transport type associated with this permission instance. 

Typeld 

Unrestricted 

CreatePermission 
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[C#] public override IPermission CreatePermission(); 

[C++] public: IPermission* CreatePermissionQ; 

[VB] Overrides Public Function CreatePermissionQ As IPermission 

[JScript] public override function CreatePermissionQ : IPermission; 

Description 

Creates and returns a new instance of the System.Net.SocketPermission 

class. 

Return Value: An instance of the System.NetSocketPermission class 

corresponding to the security declaration. 

The System.Net.SocketPermissionAttribute.CreatePermission method is 

called by the security system, not by application code. 

TransportType enumeration (System.Net) 

ToString 



Description 

Defines transport types for the System.Net.SocketPermission and 
System.Net.Sockets.Socket classes. 

The System.Net.TransportType enumeration defines transport types for 
the System.Net.SocketPermission and System.Net.Sockets.Socket classes. 

ToString 

[C#] pubhc const TransportType All; 
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[C++] public: const TransportType All; 
[VB] Public Const All As TransportType 
[JScript] public var All : TransportType; 

Description 

All transport types, 
ToString 

[C#] public const TransportType Connectionless; 
[C++] public: const TransportType Connectionless; 
[VB] Public Const Connectionless As TransportType 
[JScript] public var Connectionless : TransportType; 

Description 

The transport type is connectionless, such as UDP. 
ToString 

[C#] public const TransportType ConnectionOriented; 
[C++] public: const TransportType ConnectionOriented; 
[VB] Public Const ConnectionOriented As TransportType 
[JScript] public var ConnectionOriented : TransportType; 

Description 

The transport is connection oriented, such as TCP. 
ToString 
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[C#] public const TransportType Tcp; 
[C++] public: const TransportType Tcp; 
[VB] Public Const Tcp As TransportType 
[JScript] public var Tcp : TransportType; 

Description 

TCP transport. 
ToString 

[C#] public const TransportType Udp; 
[C++] public: const TransportType Udp; 
[VB] Public Const Udp As TransportType 
[JScript] public var Udp : TransportType; 

Description 

UDP transport. 

WebClient class (System.Net) 
ToString 



Description 

Provides common methods for sending data to and receiving data from a 
resource identified by a URI. This class cannot be inherited. 
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The System.Net.WebClieiit class provides common methods for sending 
data to or receiving data from any local, Intranet, or Internet resource identified by 
aURI. 

WebClient 
Example Syntax: 
ToString 

[C#] public WebClientQ; 

[C++] public: WebChentO; 

[VB] Public Sub NewQ 

[JScript] public function WebClientQ; 

Description 

Initializes a new instance of the System.Net.WebClient class. 
The default constructor creates a new instance of the 
System.Net. WebClient class with all fields set to null . 
BaseAddress 
ToString 

[C#] public string BaseAddress {get; set;} 

[C++] public: _property String* get_BaseAddress();public: _property void 

set_BaseAddress(String*); 

[VB] Public Property BaseAddress As String 

[JScript] public function get BaseAddress() : String;pubHc function set 
BaseAddress(String); 
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Description 

Gets or sets the base URI for requests made by a System.Net.WebClient 

The System.Net.WebClient.BaseAddress property contains a base URI 
that is combined with the relative address specified when caUing an upload or 
download method. 

Container 

Credentials 

ToString 



Description 

Gets or sets the network credentials used for authenticating the request with 

the Internet resource. 

The System.Net.WebClieiit.Credentials property contains the 
authentication credentials required to access the Internet resource. 

DesignMode 

Events 

Headers 

ToString 



Description 

Gets or sets a collection of header name/value pairs associated with the 
request, 

, 2110 MS1'862USAPP 
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The System.Net.WebClieiit.Headers property contains a 
System.Net.WebHeaderCollection instance containing header information the 
Systein.Net.WebCIient sends to the Internet resource. This is an unrestricted 
collection of headers, so setting headers that are restricted by 
System.Net.WebRequest descendants like System.Net.HttpWebRequest is 

allowed. 

QueryString 
ToString 

[C#] public NameValueCollection QueryString {get; set;} 

[C++] pubhc: _property NameValueCollection* get_QueryString();pubUc: 

_property void set_QueryString(NameValueCollection*); 

[VB] Public Property QueryString As NameValueCollection 

[JScript] pubHc function get QueryStringQ : NameValueCollection;public function 

setQueryString(NameValueCollection); 

Description 

Gets or sets a collection of query name/value pairs associated with the 
request. 

The System.Net.WebClient.QueryString property contains a 
System.Collections.Specialized.NameValueCollectioii instance containing 
name/value pairs that are appended to the URI as a query string. The contents of 
the System.Net.WebCUent.QueryString property are preceded by a question 
mark (?), and each name/value pair is separated by an ampersand (&). 

ResponseHeaders 
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ToString 

[C#] public WebHeaderCoUection ResponseHeaders {get;} 
[C++] public: property WebHeaderCoUection* get ResponseHeadersQ; 
[VB] Public Readonly Property ResponseHeaders As WebHeaderCoUection 
[JScript] public function get ResponseHeadersQ : WebHeaderCoUection; 

Description 

Gets a collection of header name/value pairs associated with the response. 

The System.Net.WebClient.ResponseHeaders property contains a 
System.Net. WebHeaderCoUection instance containing header information the 
System.Net.WebClient receives from the Internet resource. 

Site 

DownloadData 

[C#] public byte[] DownloadData(string address); 
[C++] public: unsigned char DownloadData(String* address) _gc[]; 
[VB] Public Function DownloadData(ByVal address As String) As ByteQ 
[JScript] pubhc function DownloadData(address : String) : Byte[]; 

Description 

Downloads data from a resource identified by a URI. 
Return Value: A byte array containing the data downloaded from the resource 
specified by address . 
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The System.Net.WebClieiit.DownloadData(System.String) method 
downloads the data from the URI specified by address to a local byte array. The 
URI from which the data will be downloaded. 

DownloadFile 

[C#] public void DownloadFile(string address, string fileName); 

[C++] public: void DownloadFile(String* address, String* fileName); 

[VB] Public Sub DownloadFile(ByVal address As String, ByVal fileName As 

String) 

[JScript] public function DownloadFile(address : String, fileName : String); 
Description 

Downloads data from a resource identified by a URI to a local file. 
The 

System.Net.WebClieiitDowiiloadrile(System.String,System.String) method 
downloads the data from the URI specified by address to a local file. The URI 
from which the data will be downloaded. The name of the local file to receive the 
data. 

OpenRead 

[C#] public Stream OpenRead(string address); 

[C++] public: Stream* C>penRead(String* address); 

[VB] PubUc Function C)penRead(ByVal address As String) As Stream 

[JScript] pubhc fimction OpenRead(address : String) : Stream; 
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Description 

Opens a readable stream for the data downloaded from a resource identified 
byaURI. 

Return Value: A System JO.Stream used to read data from a resource. 

The System.Net.WebClieiit.OpeiiRead(System.Striiig) method creates a 
SystemJO.Stream instance used to access the data specified by address . The 
URI from which the data will be downloaded. 

OpenWrite 



10 

11 [C#] public Stream OpenWrite(string address); 

[C++] public: Stream* OpenWrite(String* address); 
[VB] Public Function OpenWrite(ByVal address As String) As Stream 
[JScript] public function OpenWrite(address : String) : Stream; Opens a stream for 
writing data to a resource identified by a URI. 
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Description 

Opens a stream for writing data to the specified resource. 
Return Value: A System.IO.Stream used to write data to the resource. 

The System.Net.WebClient.OpenWrite(System,String) method returns a 
writable stream that is used to send data to a resource. The underlying request is 
made with the POST method. The URI of the resource to receive the data. 

OpenWrite 

[C#] public Stream OpenWrite(string address, string method); 
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[C++] public: Stream* OpenWrite(String* address, String* method); 

[VB] Public Function OpenWrite(ByVal address As String, ByVal method As 

String) As Stream 

[JScript] public function OpenWrite(address : String, method : String) : Stream; 
Description 

Opens a stream for writing data to the specified resource identified by a 
URI using the specified method. 

Return Value: A System.IO.Stream used to write data to the resource. 

The System.Net.WebClient.OpenWrite(System.String) method returns a 
writable stream that is used to send data to a resource. The underlying request is 
made with the method specified in the method parameter. The URI of the resource 
to receive the data. The method used to send the data to the resource. 

UploadData 

[C#] public byte[] UploadData(string address, byte[] data); 

[C++] public: unsigned char UploadData(String* address, unsigned char data 

_gc[])_gc[]; 

[VB] Public Function UploadData(ByVal address As String, ByVal data() As 
Byte) As Byte() 

[JScript] public function UploadData(address : String, data : Byte[]) : Byte[]; 
Uploads a data buffer to a resource identified by a URI. 

Description 
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Uploads a data buffer to the resource identified by a URI. 
Return Value: An array of bytes containing the body of any response from the 
resource. 

The System.NetWebClientUploadData(System.Strmg,System.Byte[]) 

method sends a data buffer to a resource. The underlying request is made using the 
POST method. The URI of the resource to receive the data. The data buffer to 
send to the resource. 
UploadData 

[C#] pubUc byte[] UploadData(string address, string method, byte[] data); 
[C++] public: unsigned char UploadData(String* address, String* method, 
unsigned char data gc[]) gc[]; 

[VB] PubUc Function UploadData(ByVal address As String, ByVal method As 
String, ByVal data() As Byte) As Byte() 

[JScript] public function UploadData(address : String, method : String, data : 
Byte[]) : Byte[]; 

Description 

Uploads a data buffer to the specified resource identified by a URI using 
the specified method. 

Return Value: An array of bytes containing the body of any response from the 
resource. 

The System.Net.WebClientUploadData(System.Strmg,System.Byte[]) 

method sends a data buffer to a resource using the method specified in the method 
parameter, and returns any response from the server. The URI of the resource to 
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receive the data. The method used to send the data to the resource. The data buffer 
to send to the resource. 
UploadFile 

[C#] public byte[] UploadFile(string address, string fileName); 

[C++] pubUc: unsigned char UploadFile(String* address, String* fileName) 

_gc[]; 

[VB] PubUc Function UploadFile(ByVal address As String, ByVal fileName As 
String) As Byte() 

[JScript] public function UploadFile(address : String, fileName : String) : Byte[]; 
Uploads a local file to a resource identified by a URI. 

Description 

Uploads the specified local file to the resource identified by a URI. 
Return Value: An array of bytes containing the body of any response from the 
resource. 

The System.NetWebClient»UploadFile(System,String,System.Strmg) 

method sends a local file to a resource. The underlying request is made using the 
POST method. The URI of the resource to receive the file. The file to send to the 
resource. 

UploadFile 

[C#] public byte[] UploadFile(string address, string method, string fileName); 
[C++] public: unsigned char UploadFile(String'*' address. String* method, String* 
fileName) gc[]; 
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[VB] Public Function UploadFile(ByVal address As String, ByVal method As 
String, ByVal fileName As String) As Byte() 

[JScript] public function UploadFile(address : String, method : String, fileName : 
String) : Byte[]; 

Description 

Uploads the specified local file to the specified resource identified by a URI 
using the specified method. 

Return Value: An array of bytes containing the body of any response from the 
10 resource. 

The System.Net.WebClient.UploadFile(System.String,System.String) 

method sends a local file to a resource using the method specified in the method 
13 parameter, and returns any response firom the server. The URI of the resource to 
receive the file. The method used to send the file to the resource. The file to send 

15 to the resource. 

16 UploadValues 

17 

18 [C#] public byte[] UploadValues(string address, NameValueCoUection data); 

19 [C++] pubHc: unsigned char UploadValues(String* address, 

20 NameValueCoUection* data) gc[]; 

[VB] Public Function UploadValues(ByVal address As String, ByVal data As 

22 NameValueCoUection) As ByteQ 

23 [JScript] public function UploadValues(address : String, data : 
NameValueCoUection) : Byte[]; Uploads a name/value coUection to a resource 
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25 identified by a URI. 
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Description 

Uploads the specified name/value collection to the specified resource 
identified by a URI. 

Return Value: An array of bytes containing the body of any response from the 
resource. 
The 

Systein.Net.WebCUeiit.UpIoadValues(System.String,System.CoUections.Speci 
alized.NameValueCoUection) method sends a 

System.Collections.Specialized.NameValueCollection to an Internet server. The 
underlying request is made using the POST method. The URI of the resource to 
receive the collection. The 

System.CoIlections.Specialized.NameValueCollection to send to the resource. 
UploadValues 

[C#] public byte[] UploadValues(string address, string method, 
NameValueCoUection data); 

[C++] pubHc: unsigned char UploadValues(String* address, String* method, 
NameValueCoUection* data) gc[]; 

[VB] PubHc Function UploadValues(ByVal address As String, ByVal method As 
String, ByVal data As NameValueCoUection) As ByteQ 
[JScript] pubHc function UploadValues(address : String, method : String, data : 
NameValueCoUection) : Byte[]; 

Description 
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Uploads the specified name/value collection to the specified resource 
identified by a URI using the specified method. 

Return Value: An array of bytes containing the body of any response from the 
resource. 
The 

System.Net.WebCIientUploadValues(System.String,Systeiii*ColIections.Speci 
alized.NameValueCoUection) method sends a 

System.CoUections.Specialized.NameValueCollection to a resource using the 
method specified in the method parameter, and returns any response firom the 
server. The URI of the resource to receive the collection. The method used to send 
the file to the resource. The 

System-CoIleetions.Specialized.NameValueColIection to send to the resource. 
WebException class (System.Net) 
UploadValues 

Description 

The exception that is thrown v^hen an error occurs while accessing the 
network through a pluggable protocol. 

The System^Net.WebException class is thrown by classes descended from 
System.Net.WebRequest and Systein.Net,WebResponse that implement 
pluggable protocols for accessing the Internet. 

WebException 

Example Syntax: 

UploadValues 
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1 

2 II [C#] public WebExceptionO; 

3 11 [C++] public: WebExceptionO; 

411 [VB] Public Sub New() 

5 II [JScript] public function WebExceptionQ; Initializes a new instance of the 

611 System.Net.WebException class. 

8 II Description 

Initializes a new instance of the System.Net.WebException class. 
The default constructor initializes a new instance of the 
System.Net.WebException class with all fields set to null . 
12 II WebException 

13 Example Syntax: 

14 UploadValues 



10 



n 



15 



16 
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[C#] pubUc WebException(string message); 
[C++] public: WebException(String* message); 
[VB] Public Sub New(ByVal message As String) 
[JScript] public function WebException(message : String); 



18 
19 
20 

21 II Description 



Initializes a new instance of the System.Net.WebException class with the 



23 Specified error message. 
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The System.Net.WebException instance is initialized with the 
System.Exception.Message property set to the value of message . The text of the 
error message. 

WebException 

Example Syntax: 

UploadValues 

[C#] protected WebException(SerializationInfo serializationlnfo, 
StreamingContext streamingContext); 

[C++] protected: WebException(SerializationInfo* serializationlnfo, 
StreamingContext streamingContext); 

[VB] Protected Sub New(ByVal serializationlnfo As Serializationlnfo, ByVal 
StreamingContext As StreamingContext) 

[JScript] protected function WebException(serializationInfo : Serializationlnfo, 
StreamingContext : StreamingContext); 

WebException 

Example Syntax: 

UploadValues 

[C#] public WebException(string message, Exception innerException); 
[C++] pubUc: WebException(String* message, Exception* innerException); 
[VB] Public Sub New(ByVal message As String, ByVal innerException As 
Exception) 

[JScript] pubKc function WebException(message : String, innerException : 
Exception); 
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Description 

Initializes a new instance of the System.Net.WebException class with the 
specified error message and nested exception. 

The System»Net.WebException instance is initialized with the 
System^Exception.Message property set to the value of message and the 
System.Exception JnnerException property set to the value of innerException . 
The text of the error message. A nested exception. 

WebException 

Example Syntax: 

UploadValues 

[C#] public WebException(string message, WebExceptionStatus status); 
[C++] public: WebException(String'^ message, WebExceptionStatus status); 
[VB] PubHc Sub New(ByVal message As String, ByVal status As 
WebExceptionStatus) 

[JScript] public function WebException(message : String, status : 
WebExceptionStatus) ; 

Description 

Initializes a new instance of the System.Net.WebException class with the 
specified error message and status. 

The System.Net.WebExceptioii instance is initialized with the 
System.Exception.Message property set to the value of message and the 
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System.Net.WebException.Status property set to the value of status . The text of 
the error message. One of the System^NetWebExceptionStatus values. 

WebException 

Example Syntax: 

UploadValues 

[C#] public WebExceptioii(string message, Exception innerException, 

WebExceptionStatus status, WebResponse response); 

[C++] public: WebException(String* message, Exception* innerException, 

WebExceptionStatus status, WebResponse* response); 

[VB] Public Sub New(ByVal message As String, ByVal innerException As 

Exception, ByVal status As WebExceptionStatus, ByVal response As 

WebResponse) 

[ JScript] public function WebException(message : String, innerException : 
Exception, status : WebExceptionStatus, response : WebResponse); 

Description 

Initializes a new instance of the Systeni.Net. WebException class with the 
specified error message, nested exception, status, and response. 

The System.Net.WebException instance is initialized with the 
System.Exception.Message property set to the value of message , the 
System.Exception .InnerException property set to the value of innerException , 
the System.Net.WebException.Status property set to the value of status , and the 
System.Net.WebException.Response property set to response . The text of the 
error message. A nested exception. One of the System.Net.WebExceptionStatus 
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values. A System.Net.WebResponse instance containing the response from the 
remote host. 

HelpLink 

HResult 

InnerException 

Message 

Response 

UploadValues 

Description 

Gets the response that the remote host returned. 

Some Internet protocols, such as HTTP, retum otherwise valid responses 
indicating that an error has occurred at the protocol level. When the response to an 
Internet request indicates an error, System.Net.WebRequest.GetResponse sets 
the System.Net.WebException.Status property to 
System.Net.WebExceptionStatus.ProtocolError and provides the 
System.NetWebResponse containing the error message in the 
System.Net.WebException.Response property of the 

System.Net.WebException that was thrown. The application can examine the 
System.Net.WebResponse to determine the actual error. 

Source 

StackTrace 

Status 

UploadValues 
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Description 

Gets the status of the response. 

The System.Net.WebException.Status property indicates the reason for 
the System.Net.WebException . 

TargetSite 

ISeriaHzable.GetObj ectData 

[C#] void ISerializable.GetObjectData(SerializationInfo serializationlnfo, 
StreamingContext streamingContext); 

[C++] void ISerializable::GetObjectData(SeriaUzationInfo* serializationlnfo, 
StreamingContext streamingContext); 

[VB] Sub GetObjectData(ByVal serializationlnfo As SeriaHzationlnfo, ByVal 
StreamingContext As StreamingContext) Implements ISerializable.GetObjectData 
[JScript] function ISerializable.GetObjectData(serializationInfo : Serializationlnfo, 
streamingContext : StreamingContext); 

WebExceptionStatus enumeration (System.Net) 

To String 



Description 

Defines status codes for the System.Net.WebExceptioii class. 
The System.Net.WebExceptionStatus enumeration defines the status 
codes assigned to the System.NetWebException.Status property. 
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ToString 

[C#] public const WebExceptionStatus ConnectFailure; 
[C++] public: const WebExceptionStatus ConnectFailure; 
[VB] Public Const ConnectFailure As WebExceptionStatus 
[JScript] public var ConnectFailure : WebExceptionStatus; 

Description 

The remote service point could not be contacted at the transport level. 
ToString 

[C#] public const WebExceptionStatus ConnectionClosed; 
[C++] public: const WebExceptionStatus ConnectionClosed; 
[VB] PubUc Const ConnectionClosed As WebExceptionStatus 
[JScript] public var ConnectionClosed : WebExceptionStatus; 

Description 

The connection was prematurely closed. 

ToString 

[C#] public const WebExceptionStatus KeepAliveFailure; 
[C++] public: const WebExceptionStatus KeepAliveFailure; 
[VB] Public Const KeepAliveFailure As WebExceptionStatus 
[JScript] public var KeepAliveFailure : WebExceptionStatus; 
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Description 

The connection for a request that specifies the Keep-alive header 
closed unexpectedly. 
ToString 

[C#] public const WebExceptionStatus NameResolutionFailure; 
[C++] public: const WebExceptionStatus NameResolutionFailure; 
[VB] Pubhc Const NameResolutionFailure As WebExceptionStatus 
[JScript] public var NameResolutionFailure : WebExceptionStatus; 

Description 

The name resolver service could not resolve the host name. 
ToString 

[C#] public const WebExceptionStatus Pending; 
[C++] public: const WebExceptionStatus Pending; 
[VB] Public Const Pending As WebExceptionStatus 
[JScript] pubHc var Pending : WebExceptionStatus; 

Description 

An internal asynchronous request is pending. 
ToString 

[C#] public const WebExceptionStatus PipelineFailure; 
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[C++] public: const WebExceptionStatus PipelineFailure; 
[VB] Public Const PipelineFailure As WebExceptionStatus 
[JScript] public var PipelineFailure : WebExceptionStatus; 

Description 

ToString 

[C#] public const WebExceptionStatus ProtocolError; 
[C++] public: const WebExceptionStatus ProtocolError; 
[VB] Public Const ProtocolError As WebExceptionStatus 
[JScript] public var ProtocolError : WebExceptionStatus; 

Description 

The response received from the server was complete but indicated a 
protocol-level error. For example, an HTTP protocol error such as 401 Access 
Denied would use this status. 

ToString 

[C#] public const WebExceptionStatus ProxyNameResolutionFailure; 
[C++] public: const WebExceptionStatus ProxyNameResolutionFailure; 
[VB] Public Const ProxyNameResolutionFailure As WebExceptionStatus 
[JScript] pubHc var ProxyNameResolutionFailure : WebExceptionStatus; 

Description 

The name resolver service could not resolve the proxy host name. 



iee@hayes pUc 509.324*9256 



2129 



M51-862USAPP 



ToString 

[C#] public const WebExceptionStatus ReceiveFailure; 
[C++] public: const WebExceptionStatus ReceiveFailure; 
[VB] Public Const ReceiveFailure As WebExceptionStatus 
[JScript] public var ReceiveFailure : WebExceptionStatus; 

Description 

A complete response was not received from the remote server. 
ToString 

[C#] public const WebExceptionStatus RequestCanceled; 
[C++] public: const WebExceptionStatus RequestCanceled; 
[VB] Public Const RequestCanceled As WebExceptionStatus 
[JScript] public var RequestCanceled : WebExceptionStatus; 

Description 

The request was canceled or the System.Net.WebRequest.Abort method 
was called. 

ToString 

[C#] public const WebExceptionStatus SecureChannelFailure; 
[C++] public: const WebExceptionStatus SecureChannelFailure; 
[VB] Public Const SecureChannelFailure As WebExceptionStatus 
[JScript] public var SecureChannelFailure : WebExceptionStatus; 
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Description 

An error occurred in a secure channel link. 
ToString 

[C#] public const WebExceptionStatus SendFailure; 
[C++] public: const WebExceptionStatus SendFailure; 
[VB] Public Const SendFailure As WebExceptionStatus 
[JScript] public var SendFailure : WebExceptionStatus; 

Description 

A complete request could not be sent to the remote server. 
ToString 

[C#] public const WebExceptionStatus ServerProtocolViolation; 
[C++] public: const WebExceptionStatus ServerProtocolViolation; 
[VB] Pubhc Const ServerProtocolViolation As WebExceptionStatus 
[JScript] public var ServerProtocolViolation : WebExceptionStatus; 

Description 

The server response was not a valid HTTP response. 
ToString 

[C#] pubHc const WebExceptionStatus Success; 
[C++] public: const WebExceptionStatus Success; 
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[VB] Public Const Success As WebExceptionStatus 
[JScript] public var Success : WebExceptionStatus; 

Description 

No error was encountered. This is the default value for 
System.Net.WebException.Status . 

ToString 

[C#] public const WebExceptionStatus Timeout; 
[C++] public: const WebExceptionStatus Timeout; 
[VB] Public Const Timeout As WebExceptionStatus 
[JScript] public var Timeout : WebExceptionStatus; 

Description 

No response was received during the timeout period for a request. 
ToString 

[C#] public const WebExceptionStatus TrustFailure; 
[C++] public: const WebExceptionStatus TrustFailure; 
[VB] Public Const TrustFailure As WebExceptionStatus 
[JScript] public var TrustFailure : WebExceptionStatus; 

Description 

A server certificate could not be validated. 
WebHeaderCollection class (System.Net) 
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ToString 



Description 

Contains protocol headers associated with a request or response. 
The System.Net.WebHeaderCollection class is generally accessed 
through System.Net.WebRequest.Headers or 

System.Net.WebResponse.Headers . Some common headers are considered 
restricted and are either exposed directly by the API (such as Content-Type ) or 
protected by the system and cannot be changed. 

WebHeaderCoUection 

Example Syntax: 

ToString 

[C#] public WebHeaderCoUectionO; 
[C++] pubhc: WebHeaderCoUectionO; 
[VB] Public Sub New() 

[JScript] public function WebHeaderCoUectionO; Initializes a new instance of the 
System.Net.WebHeaderCollection class. 

Description 

Initializes a new instance of the System.Net.WebHeaderCollection class. 
WebHeaderCoUection 

Example Syntax: 
ToString 



lee@hayes piic so9.324-9256 



2133 



MS1-862US.APP 



[C#] protected WebHeaderCollection(SerializationInfo serializationlnfo, 
StreamingContext streamingContext); 

[C++] protected: WebHeaderCollection(SerializationInfo* serializationlnfo, 
StreamingContext streamingContext); 

[VB] Protected Sub New(ByVal serializationlnfo As Serializationlnfo, ByVal 
StreamingContext As StreamingContext) 

[JScript] protected function WebHeaderCollection(serializationInfo : 
Serializationlnfo, streamingContext : StreamingContext); 

Description 

Initializes a new instance of the System.Net.WebHeaderCollectioii class 

from the specified instances of the 
System.Runtime.Serialization.SeriaIizatioiiInfo and 
System.Runtime.Serialization.StreamingContext classes. 

This constructor implements the 
System.Runtime.Serializatioii.ISerializable interface for the 
System.Net.WebHeaderCollection class. A 

System.Runtime.Serialization.SerializationInfocontaining the information 
required to serialize the System.Net.WebHeaderCollectioii. A 
Systein.Runtime.Serialization.StreamingContext containing the source of the 
serialized stream associated with the new System.Net.WebHeaderCollection. 

AllKeys 

Count 

IsReadOnly 
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Item 
Item 
Keys 
Add 

[C#] public void Add(string header); 
[C++] public: void Add(String* header); 
[VB] Public Sub Add(ByVal header As String) 
[JScript] public function Add(header : String); 

Description 

Inserts the specified header into the collection. 

The 

System.Net.WebHeaderCollection.Add(System.String,System.String) method 
inserts a new header into the list of header name/value pairs. The header value 
must be specified in the format "header: value". The header to add, with the name 
and value separated by a colon. 
Add 

[C#] pubHc override void Add(string name, string value); 
[C++] public: void Add(String* name, String* value); 

[VB] Overrides Public Sub Add(ByVal name As String, ByVal value As String) 
[JScript] pubhc override function Add(name : String, value : String); Inserts a new 
header into the collection. 
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Inserts a new header with the specified name and value into the collection. 
The 

System.Net.WebHeaderCollectioii.Add(System.String,System.String) method 
inserts a new header into the list of header name/value pairs. The header to add to 
the collection. The content of the header. 
AddWithoutVahdate 

[C#] protected void AddWithoutValidate(string headerName, string headerValue); 
[C++] protected: void AddWithoutValidate(String* headerName, String* 
headerValue); 

[VB] Protected Sub AddWithoutValidate(ByVal headerName As String, ByVal 
headerValue As String) 

[JScript] protected function AddWithoutValidate(headerName : String, 
headerValue : String); 

Description 

Inserts a header into the collection without checking whether the header is 
on the restricted header list. 
The 

System.Net.WebHeaderCollectioii.AddWithoutValidate(System.String,Syste 
m.String) method adds a header to the collection without checking whether the 
header is on the restricted header list. The header to add to the collection. The 
content of the header. 
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GetValues 

[C#] public override string[] GetValues(string header); 

[C++] public: String* GetValues(String* header) _gc[]; 

[VB] Overrides PubHc Function GetValues(ByVal header As String) As StringQ 

[JScript] public override function GetValues(header : String) : String[]; Gets an 

array of header values stored in a header. 

Description 

Gets an array of header values stored in a header. 

Return Value: An array of header strings. 

System.Net.WebHeaderCollection.GetValues(Systein.Strmg) returns the 

contents of the specified header as an array. The header to return. 
IsRestricted 

[C#] public static bool IsRestricted(string headerName); 

[C++] public: static bool IsRestricted(String* headerName); 

[VB] Public Shared Function IsRestricted(ByVal headerName As String) As 

Boolean 

[JScript] public static function IsRestricted(headerName : String) : Boolean; 
Description 

Tests whether the specified HTTP header can be set. 
Return Value: true if the header is restricted; otherwise false . 
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The System.Net.WebHeaderCollectioii.IsRestricted(Systeiii.String) 

method returns true to indicate that a header is restricted and must be set using 
properties instead of directly. The restricted headers are: Accept Connection Date 
Expect Host Range Referer Tests if access to the HTTP header with the provided 
name is accessible for setting. The header to test. 
OnDeseriaHzation 

[C#] pubHc override void OnDeseriahzation(object sender); 

[C++] pubHc: void OnDeserialization(Object* sender); 

[VB] Overrides PubHc Sub OnDeseriahzation(ByVal sender As Object) 

[JScript] public override function OnDeserialization(sender : Object); 

Description 

Remove 

[C#] public override void Remove(string name); 

[C++] public: void Remove(String* name); 

[VB] Overrides PubHc Sub Remove(ByVal name As String) 

[JScript] public override function Remove(name : String); 

Description 

Removes the specified header from the coHection. 
System.Net.WebHeaderCollectlon.Remove(System.String) deletes the 

specified header from the collection. If the same header was added multiple times 
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with System.Net.WebHeaderCollection.Add(System.Strmg,System.String) , a 
single call to System.Net.WebHeaderCollection.Remove(System.String) 

deletes all of the headers. The name of the header to remove from the collection. 
Set 

[C#] public override void Set(string name, string value); 
[C++] public: void Set(String* name. String* value); 

[VB] Overrides Public Sub Set(ByVal name As String, ByVal value As String) 
[JScript] public override function Set(name : String, value : String); 

Description 

Sets the specified header to the specified value. 
The 

System.Net.WebHeaderCoUection.Set(System.String,System.String) method 
inserts a new header into the list of header name/value pairs. The header value 
must be specified in the format header: value. The header to set. The content of the 

header to set. 

ISerializable.GetObjectData 

[C#] void ISerializable.GetObjectData(SeriahzationInfo seriahzationlnfo, 
StreamingContext streamingContext); 

[C++] void ISerializable::GetObjectData(SerializationInfo* seriahzationlnfo, 
StreamingContext streamingContext) ; 

[VB] Sub GetObjectData(ByVal seriahzationlnfo As Seriahzationlnfo, ByVal 
StreamingContext As StreamingContext) Implements ISerializable.GetObjectData 
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1 II [JScript] function ISerializable.GetObjectData(serializationInfo : Serializationlnfo, 
streamingContext : StreamingContext); 
ToByteArray 



3 



4 



5 II [C#] public byte[] ToByteArrayQ; 

[C++] public: unsigned char ToByteArrayQ _gc[]; 
[VB] Public Function ToByteArray() As Byte() 
8 1| [JScript] public function ToByteArray() : Byte[]; 

9 

10 1 1 Description 
It II Obsolete. 
12 1| ToString 

13 

14 I [C#] public override string ToStringQ; 

15 II [C++] public: String* ToStringQ; 

16 II [VB] Overrides Public Function ToStringQ As String 

17 II [JScript] public override function ToStringQ : String; 

18 

19 I Description 
20 II Obsolete. 

21 11 WebPermission class (System.Net) 

22 jl ToString 

23 
24] 

25 I Description 
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Controls rights to access an Internet resource. 

WebPermission 

Example Syntax: 

ToString 

[C#] public WebPermissionQ; 

[C++] public: WebPermissionQ; 

[VB] Public Sub New() 

[JScript] public function WebPermissionQ; 

Description 

Creates a new instance of the System.Net.WebPermission class. 

WebPermission 

Example Syntax: 

ToString 

[C#] public WebPermission(PermissionState state); 
[C++] public: WebPermission(PermissionState state); 
[VB] Public Sub New(ByVal state As PermissionState) 

[JScript] pubHc function WebPermission(state : PermissionState); Creates a new 
instance of the System.Net.WebPermission class. 

Description 

Creates anew instance of the System.Net.WebPermission class that 
passes all demands or fails all demands. 
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If System,Net.WebPermission is created with the Unrestricted value 
from System.Security^Permissions.PermissionState then the 
System,Net.WebPermissioii instance will pass all demands. Any other value for s 
tate will result in a System^Net.WebPermission instance that will fail all 
demands. One of the System^Security.Permissions.PermissionState values. 

WebPermission 

Example Syntax: 

ToString 

[C#] public WebPermission(NetworkAccess access, Regex uriRegex); 
[CH-+] public: WebPermission(NetworkAccess access, Regex"*" uriRegex); 
[VB] Public Sub New(ByVal access As NetworkAccess, ByVal uriRegex As 
Regex) 

[JScript] public function WebPermission(access : NetworkAccess, uriRegex : 
Regex); 

Description 

Initializes a new instance of the System.Net WebPermission class with the 
specified access rights for the specified URI regular expression. The access right 
to grant. A regular expression describing the URI to grant the access right to, 

WebPermission 

Example Syntax: 

ToString 

[C#] public WebPermission(NetworkAccess access, string uriString); 
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[C++] public: WebPermission(NetworkAccess access, String* uriString); 
[VB] Public Sub New(ByVal access As NetworkAccess, ByVal uriString As 
String) 

[JScript] public function WebPermission(access : NetworkAccess, uriString : 
String); 

Description 

Initializes a new instance of the System.Net.WebPermission class with the 
specified access rights for the specified URI. The access right to grant. A regular 
expression describing the URI to grant the access right to. 

AcceptList 

ToString 

[C#] public lEnumerator AcceptList {get;} 

[C++] public: property lEnumerator* get_AcceptList(); 

[VB] Public Readonly Property AcceptList As lEnumerator 
[JScript] pubhc function get AcceptListQ : lEnumerator; 

Description 

Returns the enumeration of permissions to export a local URI. 

ConnectList 

ToString 

[C#] pubHc lEnumerator ConnectList {get;} 

[C++] public: property lEnumerator* get_ConnectList(); 
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[VB] Public Readonly Property ConnectList As lEnumerator 
[JScript] public function get ConnectListQ : lEnumerator; 

Description 

Returns the enumeration of permissions to connect a remote URI. 
AddPermission 

[C#] public void AddPermission(NetworkAccess access, Regex uriRegex); 
[C++] public: void AddPermission(NetworkAccess access, Regex* uriRegex); 
[VB] Public Sub AddPermission(ByVal access As NetworkAccess, ByVal 
uriRegex As Regex) 

[JScript] public function AddPermission(access : NetworkAccess, uriRegex : 
Regex); 

Description 

Adds a new instance of the System.Net. WebPermission class with the 
specified access rights for the specified URI pattern. The access right to grant. A 
regular expression describing the URI to grant the access right to. 

AddPermission 

[C#] public void AddPermission(NetworkAccess access, string uriString); 
[C++] public: void AddPermission(NetworkAccess access, String* uriString); 
[VB] Public Sub AddPermission(ByVal access As NetworkAccess, ByVal 
uriString As String) 

[JScript] public function AddPermission(access : NetworkAccess, uriString : 
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string); Adds a new instance of the System.Net.WebPermission class with the 
specified access rights for the specified URI. 

Description 

Adds a new instance of the System.Net.WebPermissioii class with the 
specified access rights for the specified URI. The access right to grant. A string 
describing the URI to grant the access right to. 

Copy 

[C#] public override IPermission CopyQ; 

[C++] pubHc: IPermission* CopyQ; 

[VB] Overrides Public Function CopyQ As IPermission 

[JScript] public override function CopyQ : IPermission; 

Description 

Creates a copy of a Systeiii.Net.WebPermission instance. 
Return Value: A new instance of the System.Net.WebPerinission class that is a 
copy of the current instance. 

FromXml 

[C#] public override void FromXml(SecurityElement securityElement); 
[C++] public: void FromXml(SecurityElement* securityElement); 
[VB] Overrides Pubhc Sub FromXml(ByVal securityElement As 
SecurityElement) 

[JScript] public override function FromXml(securityElement : SecurityElement); 
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Description 

Reconstructs a System.Net.WebPermissioii instance from an XML 
encoding. 
The 

System.Net.WebPermission.rroiiiXml(Systein.Security.SecurityElemeiit) 

method reconstructs a System.Net.WebPermission instance from an XML 
encoding defined by the System.Security.SecurityElement class. The XML 
encoding to use to reconstruct the System.Net.WebPermission instance. 
Intersect 

[C#] public override IPermission Intersect(IPermission target); 

[C++] public: IPermission* Intersect(IPermission* target); 

[VB] Overrides Public Function Intersect(ByVal target As IPermission) As 

IPermission 

[JScript] pubHc override function Intersect(target : IPermission) : IPermission; 
Description 

Returns the logical intersection between two System.Net.WebPermission 

instances. 

Return Value: System.Net.WebPermission instance that represents the 
intersection of two System.Net.WebPermission instances. The 
System.Net.WebPermission instance to combine with the current instance. 
IsSubsetOf 
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[C#] public override bool IsSubsetOf(IPermission target); 
[C++] public: bool IsSubsetOf(IPermissioii* target); 

[VB] Overrides Public Function IsSubsetOf(ByVal target As IPermission) As 
Boolean 

[JScript] public override function IsSubsetOf(target : IPermission) : Boolean; 

Description 

Compares two System.Net.WebPermission instances. 
Return Value: false \i target is null ; otherwise an exception is thrown. 
The 

System.Net^WebPermission.IsSubsetOf(System.SecurityJFermission) method 
is not supported by the System.Net.WebPermissioii class. The second 
System.NetWebPermission instance to compare. 
IsUnrestricted 

[C#] pubUc bool IsUnrestrictedO; 

[C++] pubHc: sealed bool IsUnrestrictedQ; 

[VB] NotOverridable Public Function IsUnrestrictedQ As Boolean 
[JScript] public function IsUnrestrictedQ : Boolean; 

Description 

Checks the overall permission state of the object. 
Return Value: true if the System.Net.WebPermission instance was created with 
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the Unrestricted value from System.Security.Permissions.PermissionState ; 
otherwise, false . 
ToXml 

[C#] public override SecurityElement ToXmlQ; 

[C++] public: SecurityElement* ToXmlQ; 

[VB] Overrides Public Function ToXml() As SecurityElement 

[JScript] public override function ToXmlQ : SecurityElement; 

Description 

Creates an XML encoding of a System.Net.WebPermission instance and 
its current state. 

Return Value: A System.Security.SecurityElement instance containing an XML- 
encoded representation of the System.Net.WebPermission instance, including 

state information. 

The System.Net.WebPermission.ToXml method creates a 
System.Security.SecurityElement instance to XML-encode a representation of 
the System.Net.WebPermission instance, including state information. 

Union 

[C#] public override IPermission Union(IPermission target); 

[C++] public: IPermission* Union(IPermission* target); 

[VB] Overrides Pubhc Function Union(ByVal target As IPermission) As 

IPermission 

[JScript] public override function Union(target : IPermission) : IPermission; 
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Description 

Returns the logical union between two System.Net.WebPermission 
instances. 

Return Value: System.Net.WebPermissioii instance that represents the union of 
two System.Net.WebPermissioii instances. The System.Net.WebPermission 

instance to combine with the current instance. 

WebPermissionAttribute class (System.Net) 
Union 



Description 

Enables security actions for System.Net.WebPermissioii to be appHed to 
code using declarative security. This class cannot be inherited. 
WebPermissionAttribute 
Example Syntax: 
Union 

[C#] pubHc WebPermissionAttribute(SecurityAction action); 

[C++] public: WebPermissionAttribute(SecurityAction action); 

[VB] Public Sub New(ByVal action As SecurityAction) 

[JScript] public function WebPermissionAttribute(action : SecurityAction); 

Description 
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Initializes a new instance of the System-NetWebPermissionAttribute 
class with the specified System.Security.Permissions.SecurityAction . One of 
the System.Security.Permissions.SecurityAction values. 

Accept 

Union 

[C#] public string Accept {get; set;} 

[C++] public: _property String* get_Accept();public: _property void 

set_Accept(String*); 

[VB] Public Property Accept As String 

[JScript] public function get AcceptQ : String;pubUc fiinction set Accept(String); 
Description 

Gets or sets the URI accepted by this permission instance. 

AcceptPattem 

Union 

[C#] pubhc string AcceptPattem {get; set;} 

[C++] public: ^property String* get_AcceptPattem();public: __property void 

set_AcceptPattem(String*); 

[VB] Public Property AcceptPattem As String 

[JScript] pubhc function get AcceptPattemQ : String;public function set 
AcceptPattem(String); 

Description 
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Gets or sets a regular expression pattern that describes the URI accepted by 
this permission instance. 
Action 
Connect 
Union 

Description 

Gets or sets the URI connection controlled by this permission instance. 

ConnectPattem 

Union 

[C#] public string ConnectPattem {get; set;} 

[C++] public: property String* get_ConnectPattem();pubHc: _property void 

set_ConnectPattem(String*); 

[VB] Public Property ConnectPattem As String 

[JScript] public function get ConnectPattemQ : String;public function set 
ConnectPattem(String); 

Description 

Gets or sets a regular expression pattern that describes the URI connection 
controlled by this permission instance. 
Typeld 
Unrestricted 
CreatePermission 
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[C#] public override IPermission CreatePermission(); 

[C++] public: IPermission* CreatePermissionQ; 

[VB] Overrides Public Function CreatePermission() As IPermission 

[JScript] public override function CreatePermissionQ : IPermission; 

Description 

Creates and returns a new instance of the System.Net. WebPermission 

class. 

Return Value: A System.Net. WebPermission instance corresponding to the 
security declaration. 

WebProxy class (System.Net) 

To String 

Description 

Contains HTTP proxy settings for the System.Net.WebRequest class. 

The System.Net.WebProxy class contains the proxy settings that 
System.Net.WebRequest instances use to override the proxy settings in 
System.Net.GIobaIProxySelection . 

WebProxy 
Example Syntax: 
ToString 

[C#] public WebProxyQ; 
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[C++] public: WebProxyO; 
[VB] Public Sub NewQ 

[JScript] public function WebProxyQ; Initializes a new instance of the 
System.Net.WebProxy class. 

Description 

Initializes an empty instance of the System.Net.WebProxy class. 

The default constructor initializes an empty instance of the 
System.Net.WebProxy class initiahzes an empty instance of the 
System.Net.WebProxy class with the System.Net.WebProxy.Address property 
set to null. When the System.Net.WebProxy .Address property is null , the 
System.Net.WebProxy.IsBypassed(System.Uri) method retums true , and the 
System.Net.WebProxy.GetProxy(System.Uri) method retums the destination 

address. 

WebProxy 
Example Syntax: 
ToString 

[C#] public WebProxy(string Address); 
[C++] public: WebProxy(String* Address); 
[VB] Pubhc Sub New(ByVal Address As String) 
[JScript] public function WebProxy(Address : String); 

Description 
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Initializes a new instance of the System.Net^WebProxy class with the 
specified URI. 

The System.Net.WebProxy instance is initialized with the 
Systein.Net.WebProxyAddress property set to a System.Uri instance containing 
Address . The URI of the proxy server. 
WebProxy 
Example Syntax: 
ToString 

10 [C#] public WebProxy(Uri Address); 
[C++] public: WebProxy(Uri* Address); 
[VB] Public Sub New(ByVal Address As Uri) 
13 [J Script] public function WebProxy(Address : Uri); 
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Description 

Initializes a new instance of the System.Net.WebProxy class from the 
specified System.Uri . 

The System.Net.WebProxy instance is initialized with the 
System.Net.WebProxy .Address property set to the Address parameter. A 
System.Uri containing the address of the proxy server. 

WebProxy 

Example Syntax: 

ToString 

[C#] protected WebProxy(SeriahzationInfo serializationlnfo, StreamingContext 
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streamingContext) ; 

[C++] protected: WebProxy(SerializationInfo* serializationlnfo, 
StreamingContext streamingContext); 

[VB] Protected Sub New(ByVal serializationlnfo As Serializationlnfo, ByVal 
StreamingContext As StreamingContext) 

[JScript] protected function WebProxy(serializationInfo : Serializationlnfo, 
StreamingContext : StreamingContext); 

Description 

Initializes a new instance of the System.Net.WebProxy class from the 
Specified instances of the System.Runtime.Serialization.Serializationlnfo and 
System.Runtime.Serializatioii.StreamingContext classes. 

This constructor implements the 
System.Runtime.Serializatioii.ISerializable interface for the 
System.Net.WebProxy class. A 

System.Runtime.Serializatioii.SerializationInfo containing the information 
required to serialize the new System.Net.WebProxy instance. A 
System.Runtime.Serializatioii.StreamingContext containing the source and 
destination of the serialized stream associated with the new 
System.Net.WebProxy . 

WebProxy 

Example Syntax: 

ToString 

[C#] public WebProxy(string Address, bool BypassOnLocal); 
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[C++] public: WebProxy(String* Address, bool BypassOnLocal); 

[VB] Public Sub New(ByVal Address As String, ByVal BypassOnLocal As 

Boolean) 

[JScript] public function WebProxy(Address : String, BypassOnLocal : Boolean); 
Description 

Initializes a new instance of the System.Net.WebProxy class with the 
specified URI and bypass setting. 

The Systeiii.Net.WebProxy instance is initialized with the 
System.Net.WebProxy .Address property set to a System.Uri instance containing 
Address and the System.Net.WebProxy.BypassProxyOnLocal property set to 
BypassOnLocal . The URI of the proxy server, true to bypass the proxy for local 
addresses; otherwise, false. 

WebProxy 

Example Syntax: 

ToString 

[C#] public WebProxy(string Host, int Port); 

[C++] public: WebProxy(String* Host, int Port); 

[VB] Public Sub New(ByVal Host As String, ByVal Port As Integer) 

[JScript] public function WebProxy(Host : String, Port : int); 

Description 

Initializes a new instance of the System.Net.WebProxy class with the 
specified host and port number. 
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The Systein.Net.WebProxy instance is initialized with the 
System.Net.WebProxy .Address property set to a System.Uri instance of the 
form http:// Host : Port . The name of the proxy host. The port number on Host to 
use. 

WebProxy 
Example Syntax: 
ToString 

[C#] pubHc WebProxy(Uri Address, bool BypassOnLocal); 

[C++] pubHc: WebProxy(Uri* Address, bool BypassOnLocal); 

[VB] Public Sub New(ByVal Address As Uri, ByVal BypassOnLocal As 

Boolean) 

[JScript] pubUc function WebProxy(Address : Uri, BypassOnLocal : Boolean); 
Description 

Initializes a new instance of the System.Net.WebProxy class with the 
System.Uri and bypass setting. 

The System.Net.WebProxy instance is initiaHzed with the 
System.Net.WebProxy .Address property set to Address and with the 
System.Net.WebProxy.BypassProxyOnLocal property set to BypassOnLocal . A 
System.Uri containing the address of the proxy server, true to bypass the proxy 
for local addresses; otherwise, false. 

WebProxy 

Example Syntax: 

ToString 
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[C#] public WebProxy(string Address, bool BypassOnLocal, string[] BypassList); 
[C++] public: WebProxy(String* Address, bool BypassOnLocal, String* 
BypassList gc[]); 

[VB] Public Sub New(ByVal Address As String, ByVal BypassOnLocal As 
Boolean, ByVal BypassListQ As String) 

[JScript] public function WebProxy(Address : String, BypassOnLocal : Boolean, 
BypassList : String[]); 

Description 

Initializes a new instance of the System.Net.WebProxy class with the 
specified URI, bypass setting, and list of URIs to bypass. 

The System.Net.WebProxy instance is initialized with the 
System.Net.WebProxy.Address property set to a System.Uri instance containing 
Address , the System.Net.WebProxy.BypassProxyOnLocaI property set to 
BypassOnLocal , and the System.Net.WebProxy .BypassList property set to 
BypassList . The URI of the proxy server, true to bypass the proxy for local 
addresses; otherwise, false. An array of regular expression strings containing the 
URIs of the servers to bypass. 

WebProxy 

Example Syntax: 

ToString 

[C#] public WebProxy(Uri Address, bool BypassOnLocal, string[] BypassList); 
[C++] public: WebProxy(Uri* Address, bool BypassOnLocal, String* BypassList 
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_gc[]); 

[VB] Public Sub New(ByVal Address As Uri, ByVal BypassOnLocal As Boolean, 
ByVal BypassListO As String) 

[JScript] public function WebProxy(Address : Uri, BypassOnLocal : Boolean, 
BypassList : StringO); 

Description 

Initializes a new instance of the System.Net.WebProxy class with the 
specified System.Uri , bypass setting, and list of UFJs to bypass. 

The System.Net.WebProxy instance is initialized with the 
System.Net.WebProxy.Address property set to Address , the 
System.Net.WebProxy.BypassProxyOnLocal property set to BypassOnLocal , 
and the System.Net.WebProxy .BypassList property set to BypassList . A 
System.Uri containing the address of the proxy server, true to bypass the proxy 
for local addresses; otherwise, false. An array of regular expression strings 
containing the URIs of the servers to bypass. 

WebProxy 

Example Syntax: 

ToString 

[C#] public WebProxy(string Address, bool BypassOnLocal, string[] BypassList, 
ICredentials Credentials); 

[C++] public: WebProxy(String* Address, bool BypassOnLocal, String* 
BypassList gc[], ICredentials* Credentials); 

[VB] PubHc Sub New(ByVal Address As String, ByVal BypassOnLocal As 
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Boolean, ByVal BypassListQ As String, ByVal Credentials As ICredentials) 
[JScript] public function WebProxy(Address : String, BypassOnLocal : Boolean, 
BypassList : String[], Credentials : ICredentials); 

Description 

Initializes a new instance of the System.NetWebProxy class with the 
specified URI, bypass setting, list of URIs to bypass, and credentials. 

The System.Net.WebProxy instance is initialized with the 
System.Net.WebProxy .Address property set to a System.Uri instance containing 
Address , the System.Net.WebProxy.BypassProxyOnLocal property set to 
BypassOnLocal , the System.Net.WebProxy.BypassList property set to 
BypassList , and the System.Net.WebProxy .Credentials property set to 
Credentials . The URI of the proxy server, true to bypass the proxy for local 
addresses; otherwise, false. An array of regular expression strings containing the 
URIs of the servers to bypass. An System.Net.ICredentials to submit to the proxy 
server for authentication. 

WebProxy 

Example Syntax: 

ToString 

[C#] pubHc WebProxy(Uri Address, bool BypassOnLocal, string[] BypassList, 
ICredentials Credentials); 

[C++] public: WebProxy(Uri* Address, bool BypassOnLocal, String* BypassList 
gc[], ICredentials* Credentials); 

[VB] Public Sub New(ByVal Address As Uri, ByVal BypassOnLocal As Boolean, 
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ByVal BypassListQ As String, ByVal Credentials As ICredentials) 

[JScript] public function WebProxy(Address : Uri, BypassOnLocal : Boolean, 

BypassList : String[], Credentials : ICredentials); 

Description 

Initializes a new instance of the System.Net.WebProxy class with the 
specified System.Uri , bypass setting, list of URIs to bypass, and credentials. 

The System.Net.WebProxy instance is initialized with the 
System.Net.WebProxy .Address property set to Address , the 
System.Net.WebProxy.BypassProxyOnLocal property set to BypassOnLocal , 
the Systein.Net.WebProxy .BypassList property set to BypassList , and the 
System.Net.WebProxy .Credentials property set to Credentials A System.Uri 
containing the address of the proxy server, true to bypass the proxy for local 
addresses; otherwise, false. An array of regular expression strings containing the 
URIs of the servers to bypass. An System.Net.ICredentials to submit to the proxy 
server for authentication. 

Address 

ToString 

[C#] public Uri Address {get; set;} 

[C++] pubUc: _property Uri* get_Address();pubUc: property void 

set_Address(Uri*); 

[VB] Public Property Address As Uri 

[JScript] public function get AddressQ : Uri;public fUnction set Address(Uri); 
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Description 

Gets or sets the address of the proxy server. 

The System.Net.WebProxy. Address property contains the address of the 
proxy server. When System.Net.WebProxy .Address is null , all requests bypass 
the proxy and connect directly to the destination host. 

BypassArrayList 

ToString 

[C#] public ArrayList BypassArrayList {get;} 
[C++] public: _property ArrayList* get_BypassArrayList(); 
[VB] Public Readonly Property BypassArrayList As ArrayList 
[JScript] public function get BypassArrayListQ : ArrayList; 

Description 

Gets a list of addresses that do not use the proxy server. 

The System.Net.WebProxy.BypassList property contains an array of URI 
strings that a System.Net.WebRequest instance accesses directly instead of 
through the proxy server. 

BypassList 

ToString 

[C#] pubUc string[] BypassList {get; set;} 

[C++] public: __property String* get_BypassList();public: __property void 
set_BypassList(String* gc[]); 
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[VB] Public Property BypassList As String () 

[JScript] public function get BypassListQ : String[];public function set 

BypassList(String[]); 

Description 

Gets or sets an array of addresses that do not use the proxy server. 

The System.Net.WebProxy .BypassList property contains an array of 
regular expressions that describe URIs that a System.Net.WebRequest instance 
accesses directly instead of through the proxy server. 

BypassProxyOnLocal 

ToString 

[C#] public bool BypassProxyOnLocal {get; set;} 

[C++] pubhc: __property bool get_BypassProxyOnLocal();public: _property 

void set_BypassProxyOnLocal(bool); 

[VB] Public Property BypassProxyOnLocal As Boolean 

[JScript] public function get BypassProxyOnLocalQ : Boolean;public function set 
BypassProxyOnLocal(Boolean) ; 

Description 

Gets or sets a value indicating whether to bypass the proxy server for local 
addresses. 

The setting of the System.Net.WebProxy .BypassProxyOnLocal property 
determines whether System.Net.WebRequest instances use the proxy server 
when accessing local Internet resources. 
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Credentials 
ToString 

[C#] public ICredentials Credentials {get; set;} 

[C++] public: _property ICredentials* get_Credentials();public: _property void 

set_Credentials(ICredentials*); 

[VB] Public Property Credentials As ICredentials 

[JScript] public function get CredentialsQ : ICredentials;public function set 
Credentials(ICredentials); 

Description 

Gets or sets the credentials to submit to the proxy server for authentication. 

The System.Net.WebProxy .Credentials property contains the 
authentication credentials to send to the proxy server in response to an HTTP 407 
(proxy authorization) status code. 

GetDefaultProxy 

[C#] pubHc static WebProxy GetDefaultProxy(); 

[C++] public: static WebProxy* GetDefaultProxyQ; 

[VB] Public Shared Function GetDefaultProxyQ As WebProxy 

[JScript] pubMc static function GetDefaultProxy() : WebProxy; 

Description 
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Reads the Internet Explorer nondynamic proxy settings. 
Return Value: A System.Net.WebProxy instance containing the nondynamic 
proxy settings from Internet Explorer 5.5. 

The System.Net.WebProxy.GetDefaultProxy method reads the 
nondynamic proxy settings stored by Internet Explorer 5.5 and creates a 
System.Net.WebProxy instance with those settings. 

GetProxy 

[C#] public Uri GetProxy(Uri destination); 

[C++] public: _sealed Uri* GetProxy(Uri* destination); 

[VB] NotOverridable Public Function GetProxy(ByVal destination As Uri) As Uri 
[JScript] public function GetProxy(destination : Uri) : Uri; 

Description 

Returns the proxied URI for a request. 
Return Value: The System.Uri of the Internet resource, if the resource is on the 
bypass list; otherwise, the System.Uri of the proxy. 

The System.Net.WebProxy.GetProxy(System.Uri) method returns the 
URI that the System.Net.WebRequest uses to access the Internet resource. The 
System.Uri of the requested Internet resource. 

IsBypassed 

[C#] pubUc bool IsBypassed(Uri host); 

[C++] public: _sealed bool IsBypassed(Uri* host); 

[VB] NotOverridable Public Function IsBypassed(ByVal host As Uri) As Boolean 
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[JScript] public function IsBypassed(host : Uri) : Boolean; 
Description 

Indicates whether to use the proxy server for the specified host. 
Return Value: true if the proxy server should not be used for host ; otherwise, 
false . 

The System.Net.WebProxy.IsBypassed(System.Uri) method is used to 
determine whether to bypass the proxy server when accessing an Internet resource. 
The System.Uri of the host to check for proxy use. 

ISerializable.GetObjectData 

[C#] void ISerializable.GetObjectData(SeriaUzationInfo serializationlnfo, 
StreamingContext streamingContext); 

[C++] void ISerializable::GetObjectData(SerializationInfo* seriaHzationlnfo, 
StreamingContext streamingContext); 

[VB] Sub GetObjectData(ByVal serializationlnfo As Serializationlnfo, ByVal 
StreamingContext As StreamingContext) Implements ISerializable.GetObjectData 
[JScript] function ISerializable.GetObjectData(serializationInfo : Serializationlnfo, 
streamingContext : StreamingContext); 

WebRequest class (System.Net) 

ToString 



Description 
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Makes a request to a Uniform Resource Identifier (URI). This is an 
abstract class. 

System.Net.WebRequest is the abstract base class for the .NET 
Framework's request/response model for accessing data from the Internet. An 
application that uses the request/response model can request data from the Internet 
in a protocol-agnostic manner, in which the application works with instances of 
the System.Net.WebRequest class while protocol-specific descendant classes 
carry out the details of the request. 

WebRequest 

Example Syntax: 

ToString 

[C#] protected WebRequestQ; 
[C++] protected: WebRequestQ; 
[VB] Protected Sub New() 

[JScript] protected function WebRequestQ; Initializes a new instance of the 
System.Net. WebRequest class. 

Description 

Initializes a new instance of the System.Net.WebRequest class. 

Use the System.Net.WebRequest.Create(System.Uri,System.Booleaii) 

method to initialize new System.Net.WebRequest instances. Do not use the 
constructor. 

WebRequest 

Example Syntax: 
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ToString 



[C#] protected WebRequest(SerializationInfo serializationlnfo, StreamingContext 
streamingContext) ; 

[C++] protected: WebRequest(SerializationInfo* serializationlnfo, 
StreamingContext StreamingContext); 

[VB] Protected Sub New(ByVal serializationlnfo As Serializationlnfo, ByVal 
StreamingContext As StreamingContext) 

[JScript] protected function WebRequest(serializationInfo : Serializationlnfo, 
StreamingContext : StreamingContext); 

Description 

Initializes a new instance of the System.Net.WebRequest class from the 
specified instances of the System.Runtime.Serializatioii.SerializationInfo and 
System.Runtime.Serialization.StreamingContext classes. 

When implemented by a descendant class, this constructor implements the 
System.Runtime.Serializatioii.ISerializable interface for the 
System.Net.WebRequest descendant. A 

System.Runtime.Serializatioii.SerializationInfo that contains the information 
required to seriaUze the new System.Net-WebRequest instance. A 
System.Ruiitime.Serialization.StreainingContext that indicates the source of the 
serialized stream associated with the new System.Net.WebRequest instance. 

ConnectionGroupName 

ToString 
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[C#] public virtual string ConnectionGroupName {get; set;} 

[C++] public: property virtual String* get_ConnectionGroupName();public: 

property virtual void set_ComiectionGroupName(String*); 

[VB] Overridable Public Property ConnectionGroupName As String 

[JScript] public function get ConnectionGroupName() : String;public function set 

ConnectionGroupName(String); 

Description 

When overridden in a descendant class, gets or sets the name of the 

connection group for the request. 

The System.Net.WebRequest.ConnectionGroupName property 
associates specific requests within an application to one or more connection pools. 

ContentLength 

ToString 

[C#] public virtual long ContentLength {get; set;} 

[C++] public: _property virtual _int64 get_ContentLength();public: __property 

virtual void set_ContentLength( ^int64); 

[VB] Overridable Public Property ContentLength As Long 

[JScript] pubHc function get ContentLengthQ : long;pubHc function set 

ContentLength(long); 

Description 
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When overridden in a descendant class, gets or sets the content length of 

the request data being sent. 

The System.Net.WebRequest.ContentLength property contains the 

number of bytes of data sent to the Internet resource by the 

System.Net.WebRequest instance. 

ContentType 

ToString 

[C#] public virtual string ContentType {get; set;} 

[C++] public: _property virtual String* get_ContentType();public: __property 

virtual void set_ContentType(String*); 

[VB] Overridable Public Property ContentType As String 

[JScript] public function get ContentTypeQ : String;public function set 

ContentType(String); 

Description 

When overridden in a descendant class, gets or sets the content type of the 

request data being sent. 

The System.Net.WebRequest.ContentType property contains the media 
type of the request. This is typically the MIME encoding of the content. 

Credentials 

ToString 

[C#] pubUc virtual ICredentials Credentials {get; set;} 

[C++] public: property virtual ICredentials* get_Credentials();pubHc: 
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property virtual void set_Credentials(ICredentials*); 
[VB] Overridable Public Property Credentials As ICredentials 
[JScript] public function get CredentialsQ : ICredentials;public function set 
Credentials(ICredentials); 

Description 

When overridden in a descendant class, gets or sets the network credentials 
used for authenticating the request with the Internet resource. 

The System.Net.WebRequest.Credeiitials property contains the 
authentication credentials required to access the Internet resource. 

Headers 

ToString 

[C#] public virtual WebHeaderCollection Headers {get; set;} 

[C++] public: property virtual WebHeaderCollection* get_Headers();pubhc: 

property virtual void set_Headers(WebHeaderCollection*); 

[VB] Overridable Public Property Headers As WebHeaderCollection 

[JScript] public function get HeadersQ : WebHeaderCollection;public function set 

Headers(WebHeaderCollection) ; 

Description 

When overridden in a descendant class, gets or sets the collection of header 
name/value pairs associated with the request. 
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The System.Net.WebRequest,Headers property contains a 
System.Net.WebHeaderCollection instance containing the header information to 
send to the Internet resource. 
Method 
ToString 

[C#] public virtual string Method {get; set;} 

[C++] public: _jproperty virtual String* get__Method();public: __property virtual 

9 void set_Method(String*); 

10 [VB] Overridable Public Property Method As String 

n [JScript] public function get Method() : String;public function set Method(String); 

12 

13 Description 

14 When overridden in a descendant class, gets or sets the protocol method to 

15 use in this request. 
When overridden in a descendant class, the 

System.Net,WebRequest.Method property contains the request method to use in 

this request, 

PreAuthenticate 
ToString 



16 
17 
18 
19 



20 



21 



22 



23 



24 



25 



[C#] public virtual bool PreAuthenticate {get; set;} 

[C++] pubhc: _property virtual bool get_PreAuthenticate();public: _property 
virtual void set_PreAuthenticate(bool); 

[VB] Overridable Public Property PreAuthenticate As Boolean 
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10 



11 



12 



[JScript] public function get PreAuthenticateQ : Boolean;public function set 
PreAutlienticate(Boolean); 

Description 

When overridden in a descendant class, indicates whether to 
preauthenticate the request. 

The System.Net.WebRequest.PreAuthenticate property indicates 
whether to send authentication information with the initial request. When 
System.Net.WebRequest.PreAutheiiticate is false , the 
System.Net.WebRequest waits for an authentication challenge before sending 
authentication information. 

Proxy 



13 ToString 



14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 



[C#] pubhc virtual IWebProxy Proxy {get; set;} 

[C++] public: _property virtual IWebProxy* get_Proxy();public: _jproperty 

virtual void set_Proxy(IWebProxy*); 

[VB] Overridable Public Property Proxy As IWebProxy 

[JScript] public function get ProxyQ : IWebProxy;public function set 

Proxy(IWebProxy); 

Description 

When overridden in a descendant class, gets or sets the network proxy to 
use to access this Internet resource. 
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The System.Net.WebRequest.Proxy property identifies the network proxy 
that the request uses to access the Internet resource. The request is made through 
the proxy server rather than directly to the Internet resource. 

RequestUri 

ToString 

[C#] public virtual Uri RequestUri {get;} 

[C++] public: __property virtual Uri* get_RequestUri(); 

[VB] Overridable Pubhc ReadOnly Property RequestUri As Uri 

[JScript] public function get RequestUriQ : Uri; 

Description 

When overridden in a descendant class, gets the URI of the Internet 
resource associated with the request. 

When overridden in a descendant class, the 
System.Net.WebRequest.RequestUri property contains the System.Uri instance 
that System.Net.WebRequest.Create(System.Uri,System.Boolean) method uses 

to create the request. 
Timeout 
ToString 

[C#] public virtual int Timeout {get; set;} 

[C++] public: __property virtual int get_TimeoutO;public: __property virtual void 
set_Timeout(int) ; 

[VB] Overridable Public Property Timeout As Integer 
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[JScript] public function get Timeout() : int;public function set Timeout(int); 
Description 

Gets or sets the length of time before the request times out. 

The System.Net.WebRequest.Timeout property indicates the length of 
time, in milliseconds, until the request times out and throws a 
System.Net.WebExceptioii . The System.Net.WebRequest.Timeout property 
affects only synchronous requests made with the 

System.Net.WebRequest.GetResponse method. To time out asynchronous 
requests, use the System.Net.WebRequestAbort method. 
Abort 

[C#] pubhc virtual void AbortQ; 
[C++] pubhc: virtual void AbortQ; 
[VB] Overridable Public Sub AbortQ 
[JScript] pubhc function AbortQ; 

Description 

Cancels an asynchronous request to an Internet resource. 
The System.Net.WebRequest.Abort method cancels asynchronous 
requests to Internet resources started with the 

System.Net.WebRequest.BeginGetResponse(System.AsyncCallback,System.O 

bject) method. 

BeginGetRequestStream 
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[C#] public virtual lAsyncResult BeginGetRequestStream(AsyncCallback 
callback, object state); 

[C++] public: virtual lAsyncResult* BeginGetRequestStream(AsyncCallback* 
callback, Object* state); 

[VB] Overridable Public Function BeginGetRequestStream(ByVal callback As 
AsyncCallback, ByVal state As Object) As lAsyncResult 

[JScript] public function BeginGetRequestStream(callback : AsyncCallback, state 
: Object) : lAsyncResult; 

Description 

When overridden in a descendant class, provides an asynchronous version 
of the Systeiii.Net.WebRequest.GetRequestStream method. 
Return Value: An System.IAsyncResult that references the asynchronous request. 

The 

System.Net.WebRequest.BeginGetRequestStream(System.AsyncCallback,Sys 
tem.Object) method starts an asynchronous request for a stream used to send data 
to an Internet resource. The callback method that implements the 
SystemAsyncCallback delegate uses the 

System.Net.WebRequest.EndGetRequestStream(Systeni.IAsyncResult) 

method to return the request stream. The System. AsyncCallback delegate. An 
object containing state information for this asynchronous request. 
BeginGetResponse 

[C#] pubhc virtual lAsyncResult BeginGetResponse(AsyncCallback callback, 



lee@hayes m 309.324*9255 



2176 



MS1-862U5APP 



object state); 

[C++] public: virtual lAsyncResult* BeginGetResponse(AsyncCallback* 
callback, Object* state); 

[VB] Overridable Public Function BeginGetResponse(ByVal callback As 
AsyncCallback, ByVal state As Object) As lAsyncResult 
[JScript] public function BeginGetResponse(callback : AsyncCallback, state : 
Object) : lAsyncResult; 

Description 

When overridden in a descendant class, begins an asynchronous request for 
an Internet resource. 

Return Value: An System.IAsyncResult that references the asynchronous request. 
The 

System.Net.WebRequest.BeginGetResponse(System.AsyncCallback,System.O 
bject) method starts an asynchronous request for a response. The callback method 
that implements the System.AsyncCallback delegate uses the 
Systera.Net.WebRequest.EndGetResponse(System.IAsyncResult) method to 

return the System.Net.WebResponse from the Internet resource. The 
System.AsyncCaIlback delegate. An object containing state information for this 
asynchronous request. 
Create 

[C#] public static WebRequest Create(string requestUriString); 
[C++] public: static WebRequest* Create(String* requestUriString); 
[VB] Pubhc Shared Function Create(ByVal requestUriString As String) As 
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WebRequest 

[JScript] public static function Create(requestUriString : String) : WebRequest; 
Initializes a new System.Net. WebRequest . 

Description 

Initializes a new System.NetWebRequest instance for the specified URI 
scheme. 

Return Value: A Systein.Net.WebRequest descendant for the specific URI 
scheme. 

TheSystem.Net.WebRequest.Create(System.Uri,Systein.Boolean) 

method returns a descendant of the System.Net.WebRequest class determined at 
run time by the scheme of the URI in requestUriString . For example, when a URI 
beginning with http:// is passed in requestUriString , an 
System.Net.Http WebRequest instance is returned by 
System.Net.WebRequest.Create(System.Uri,System.Boolean) . If a URI 

beginning with file:// is passed instead, the 

System.Net.WebRequest.Create(System.Uri,System.BooIean) method will 
return a System.Net.FileWebRequest instance. The URI that identifies the 
Internet resource. 
Create 

[C#] public static WebRequest Create(Uri requestUri); 

[C++] public: static WebRequest* Create(Uri* requestUri); 

[VB] Public Shared Function Create(ByVal requestUri As Uri) As WebRequest 

[JScript] public static function Create(requestUri : Uri) : WebRequest; 
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2 Description 

3 Initializes a new System.Net.WebRequest instance for the specified URI 
scheme. 

Return Value: A System.NetWebRequest descendant for the specified URI 
scheme. 

The System.NetWebRequest.Create(System.Uri,System.Boolean) 

method returns a descendant of the System.Net^WebRequest class determined at 
run time by the scheme of the URI in requestUri . For example, when a URI 
beginning with http:// is passed in requestUri , an System.Net.HttpWebRequest 

1 1 instance is retumed by 

System,Net.WebRequestCreate(System.Uri,System.Booleaii) If a URI 

13 beginning with file:// is passed instead, the 

System.Net.WebRequestCreate(System.Uri,System.Boolean) method will 
retum a System.Net.FileWebRequest instance. A System.Uri containing the URI 
16 of the requested resource. 
CreateDefault 



10 



12 



14 



15 
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[C#] public static WebRequest CreateDefauh(Uri requestUri); 
[C++] pubhc: static WebRequest* CreateDefault(Uri* requestUri); 
[VB] Public Shared Function CreateDefault(ByVal requestUri As Uri) As 
WebRequest 

[JScript] pubhc static function CreateDefault(requestUri : Uri) : WebRequest; 
Description 
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Initializes a new System.Net.WebRequest instance for the specified URI 
scheme. 

Return Value: A System.Net.WebRequest descendant for the specified URI 
scheme. 

The System.Net.WebRequest.CreateDefault(System.Uri) method returns 
a System.Net.WebRequest descendant instance based on only the scheme portion 
of a URI. A System-Uri containing the URI of the requested resource. 

EndGetRequestStream 

[C#] public virtual Stream EndGetRequestStream(IAsyncResult asyncResult); 
[C++] pubhc: virtual Stream* EndGetRequestStream(IAsyncResuh* 
asyncResult); 

[VB] Overridable Public Function EndGetRequestStream(ByVal asyncResult As 
lAsyncResult) As Stream 

[JScript] public function EndGetRequestStream(asyncResult : lAsyncResult) : 
Stream; 

Description 

When overridden in a descendant class, returns a System-IO.Stream for 
writing data to the Internet resource. 
Return Value: A System.IO.Stream to write data to. 

The 

System.Net.WebRequest.EndGetRequestStreain(Systeiii.IAsyncResuIt) 

method completes an asynchronous stream request that was started by the 
System.Net.WebRequest.BeginGetRequestStream(System.AsyncCaUback,Sys 
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10 



tem.Object) method. An System.IAsyncResult that references a pending request 

for a stream. 

EndGetResponse 

[C#] public virtual WebResponse EndGetResponse(IAsyncResult asyncResult); 
[C++] public: virtual WebResponse* EndGetResponse(IAsyncResult* 
asyncResult); 

[VB] Overridable PubUc Function EndGetResponse(ByVal asyncResult As 
lAsyncResult) As WebResponse 

[JScript] pubUc function EndGetResponse(asyncResult : lAsyncResult) : 



11 I WebResponse; 

12 

13 Description 

When overridden in a descendant class, returns a 
System.Net. WebResponse . 

Return Value: A System.Net.WebResponse that contains a response to the 
Internet request. 

The System.Net.WebRequest.EndGetResponse(System.IAsyncResult) 

method completes an asynchronous request for an Internet resource that was 
started with the 

System,Net.WebRequestBeginGetRespoiise(SystemAsyncCallback,Systeiii.O 
bject) method. An System.IAsyncResult that references a pending request for a 
response. 

GetRequestStream 



14 



15 



16 



17 
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2 [C#] public virtual Stream GetRequestStreamQ; 

3 [C++] public: virtual Stream* GetRequestStreamQ; 

4 [VB] Overridable Public Function GetRequestStreamQ As Stream 

5 [JScript] public function GetRequestStream() : Stream; 

6 

7 Description 

8 When overridden in a descendant class, returns a System.IO.Stream for 

9 writing data to the Internet resource. 

10 Return Value: A System.IO.Stream for writing data to the Internet resource. 

1 1 The System.Net.WebRequest.GetRequestStream method initiates a 

12 request to send data to the Internet resource and returns a System.IO.Stream 

13 instance for sending data to the Internet resource. 

14 GetResponse 

15 

16 [C#] public virtual WebResponse GetResponseQ; 

17 [C++] public: virtual WebResponse* GetResponse(); 

18 [VB] Overridable Public Function GetResponse() As WebResponse 

19 [JScript] public function GetResponse() : WebResponse; 

20 

21 Description 

22 When overridden in a descendant class, returns a response to an Internet 

23 request. 

24 Return Value: A System.Net.WebResponse containing the response to the 

25 Internet request. 
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The System.Net.WebRequest.GetResponse method sends a request to an 
Internet resource and returns a System.NetWebResponse instance. If the request 
has already been initiated by a call to 
System.Net.WebRequest.GetRequestStream , the 

System.Net.WebRequest.GetResponse method completes the request and returns 

any response. 

RegisterPrefix 

[C#] public static bool RegisterPrefix(string prefix, IWebRequestCreate creator); 
[C++] pubHc: static bool RegisterPrefix(String* prefix, IWebRequestCreate* 
creator); 

[VB] Public Shared Function RegisterPrefix(ByVal prefix As String, ByVal 
creator As IWebRequestCreate) As Boolean 

[JScript] pubhc static function RegisterPrefix(prefix : String, creator : 
IWebRequestCreate) : Boolean; 

Description 

Registers a System.Net.WebRequest descendant for the specified URL 
Return Value: true if registration is successful; otherwise, false . 
The 

System.Net.WebRequest.RegisterPrefix(System.String,System.Net.IWebRequ 
estCreate) method registers System.Net.WebRequest descendants to service 
requests. The URI prefix that the System.Net.WebRequest descendant services. 
The create method that the System.Net.WebRequest calls to create the 
System.Net.WebRequest descendant. 
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ISerializable.GetObjectData 

[C#] void ISerializable.GetObjectData(SerializationInfo serializationlnfo, 
4 II StreamingContext streamingContext); 

yoid lSerializable::GetObjectData(SerializationInfo* serializationlnfo, 

StreamingContext streamingContext); 

[VB] Sub GetObjectData(ByVal serializationlnfo As Serializationlnfo, ByVal 
StreamingContext As StreamingContext) Implements ISerializable.GetObjectData 
[JScript] function ISerializable.GetObjectData(serializationInfo : Serializationlnfo, 
streamingContext : StreamingContext); 
WebResponse class (System.Net) 
12 1 1 ToString 

13 
14 

15 1 1 Description 

Provides a response from a Uniform Resource Identifier (URI). This is an 
abstract class. 

The System-NetWebResponse class is the abstract base class from which 
protocol-specific response classes are derived. Applications can use the 
System.Net-WebResponse class to handle responses in a protocol-agnostic 
manner. In that case, the application works with instances of the 
System.Net. WebResponse class while the details of the request are carried out by 
23 II protocol-specific descendant classes. 

24 WebResponse 

25 Example Syntax: 



16 
17 
18 
19 
20 
21 
22 
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ToString 

[C#] protected WebResponseQ; 
[C++] protected: WebResponseQ; 
[VB] Protected Sub New() 

[JScript] protected function WebResponseQ; Initializes a new instance of the 
System.Net.WebResponse class. 

Description 

Initializes a new instance of the System.Net.WebResponse class. 

Applications do not call the System.Net.WebResponse constructor 
directly, use the System.Net.WebRequest.GetResponse method on a 
System.Net.WebRequest instance. 

WebResponse 

Example Syntax: 

ToString 

[C#] protected WebResponse(SerializationInfo serializationlnfo, 
StreamingContext streamingContext); 

[C++] protected: WebResponse(SerializationInfo* seriahzationlnfo, 
StreamingContext streamingContext); 

[VB] Protected Sub New(ByVal serializationlnfo As Seriahzationlnfo, ByVal 
StreamingContext As StreamingContext) 

[JScript] protected function WebResponse(serializationInfo : Seriahzationlnfo, 
StreamingContext : StreamingContext); 
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Description 

Initializes a new instance of the Systein.Net.WebResponse class from the 
specified instances of the System.Ruiitime.Serializatioii.SerializatioiiInfo and 
System.Ruiitime.Serialization.StreammgCoiitext classes. 

When implemented by a descendant class, this constractor implements the 
System.Runtime.Serializatioii.ISerializable interface for the 
System.Net.WebResponse descendant. An instance of the 

System.Runtime.Serializatioii.SerializationInfo class containing the information 
required to serialize the new System.Net.WebRequest instance. An instance of 
the System.Runtime.Serializatioii.StreamingCoiitext class indicating the source 
of the serialized stream associated with the new System.Net.WebRequest 
instance. 

ContentLength 

ToString 

[C#] public virtual long ContentLength {get; set;} 

[C++] pubHc: property virtual _int64 get_ContentLength();public: _property 

virtual void set_ContentLength(_int64); 

[VB] Overridable Public Property ContentLength As Long 

[JScript] public function get ContentLengthQ : long;pubHc function set 

ContentLength(long); 

Description 
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When overridden in a descendant class, gets or sets the content length of 

data being received. 

The Systein.Net.WebResponse.ContentLeiigth property contains the 

length, in bytes, of the response from the Internet resource. For request methods 

that contain header information, the System.Net.WebResponse.ContentLength 

does not include the length of the header information. 

ContentType 

ToString 

[C#] pubHc virtual string ContentType {get; set;} 

[C++] pubKc: property virtual String* get_ContentType();pubHc: _j)roperty 

virtual void set_ContentType(String*); 

[VB] Overridable Pubhc Property ContentType As String 

[JScript] public function get ContentType() : String;public function set 

ContentType(String); 

Description 

When overridden in a derived class, gets or sets the content type of the data 
being received. 

The System.Net.WebResponse.ContentType property contains the MIME 
content type of the response from the Internet resource, if known. 
Headers 
ToString 

[C#] public virtual WebHeaderCollection Headers {get;} 
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[C++] public: property virtual WebHeaderCoUection* get_Headers(); 

[VB] Overridable Public ReadOnly Property Headers As WebHeaderCoUection 

[ JScript] public function get HeadersQ : WebHeaderCoUection; 

Description 

When overridden in a derived class, gets a collection of header name-value 
pairs associated with this request. 

The System.Net.WebResponse.Headers property contains the name-value 

header pairs returned in the response. 
ResponseUri 
ToString 

[C#] public virtual Uri ResponseUri {get;} 

[C++] pubHc: property virtual Uri* get ResponseUriQ; 

[VB] Overridable Public ReadOnly Property ResponseUri As Uri 

[JScript] pubHc function get ResponseUriQ : Uri; 

Description 

When overridden in a derived class, gets the URI of the Internet resource 

that actually responded to the request. 

The System.Net.WebResponse.ResponseUri property contains the URI of 
the Internet resource that actually provided the response data. This resource may 
not be the originally requested Um if the underlying protocol allows redirection of 
the request. 

Close 
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[C#] public virtual void CloseQ; 

public: virtual void CloseQ; 
[VB] Overridable Public Sub CloseQ 
[JScript] public function CloseQ; 

Description 

When overridden by a descendent class, closes the response stream. 

The System.Net^WebResponse.Close method cleans up the resources used 
by a System.Net.WebResponse and closes the underlying stream by calling the 
System.IO.Stream.Close method. 

GetResponseStream 

[C#] public virtual Stream GetResponseStreamQ; 

[C++] public: virtual Stream* GetResponseStreamQ; 

fVB] Overridable Public Function GetResponseStreamQ As Stream 

[JScript] public function GetResponseStreamQ : Stream; 

Description 

When overridden in a descendant class, returns the data stream from the 
Internet resource. 

Return Value: An instance of the System JO.Stream class for reading data from 
the Internet resource. 

The System^Net.WebResponse.GetResponseStream method returns the 
data stream from the Internet resource. 
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IDisposable.Dispose 

[C#] void IDisposable.DisposeQ; 
[C++] void IDisposable::Dispose(); 
[VB] Sub DisposeQ Implements IDisposable.Dispose 
[JScript] function IDisposable.DisposeQ; 
ISerializable.GetObj ectData 

[C#] void ISeria 

System.NetSockets 

The namespace provides a managed implementation of the Windows 
Sockets interface for developers that need to tightly control access to the network. 
Developers familiar with the Winsock API should have no problems developing 
applications using the class. 

Description 

The System.Net^Sockets namespace provides a managed implementation 
of the Windows Sockets interface for developers that need to tightly control access 
to the network. Developers familiar with the Winsock API should have no 
problems developing applications using the System.Net.Sockets.Socket class. 

AddressFamily enumeration (System.Net. Sockets) 

Description 
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Specifies the addressing scheme that an instance of the 
System.Net.Sockets.Socket class can use. 

An Systein.Net.Sockets.AddressFamily member specifies the addressing 
scheme that a System.Net.Sockets.Socket instance uses to resolve an address. For 
example, System.Net.Sockets.AddressFamiIy.InterNetwork indicates that an IP 
version 4 address is expected when a System.Net.Sockets.Socket connects to an 
end point. 

[C#] public const AddressFamily AppleTalk; 
[C++] public: const AddressFamily AppleTalk; 
[VB] Public Const AppleTalk As AddressFamily 
[JScript] public var AppleTalk : AddressFamily; 

Description 

AppleTalk address. 

[C#] public const AddressFamily Attn; 
[C++] public: const AddressFamily Atm; 
[VB] Public Const Atm As AddressFamily 
[JScript] pubHc var Atm : AddressFamily; 

Description 

Native ATM services address. 

[C#] public const AddressFamily Banyan; 
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[C++] public: const AddressFamily Banyan; 
[VB] Public Const Banyan As AddressFamily 
[JScript] public var Banyan : AddressFamily; 

Description 

Banyan address. 

[C#] public const AddressFamily Ccitt; 
[C++] public: const AddressFamily Ccitt; 

10 [VB] Public Const Ccitt As AddressFamily 

11 [JScript] public var Ccitt : AddressFamily; 

12 

13 Description 

14 Addresses for CCITT protocols, such as X.25. 

15 

16 [C#] public const AddressFamily Chaos; 

17 [C++] public: const AddressFamily Chaos; 

18 [VB] Public Const Chaos As AddressFamily 

19 [JScript] public var Chaos : AddressFamily; 

20 

21 Description 

22 Address for MIT CHAOS protocols. 

23 

24 [C#] public const AddressFamily Cluster; 

25 [C++] public: const AddressFamily Cluster; 
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[VB] Public Const Cluster As AddressFamily 
[JScript] public var Cluster : AddressFamily; 

Description 

Address for Microsoft cluster products. 

[C#] public const AddressFamily DataKit; 
[C++] public: const AddressFamily DataKit; 
[VB] Public Const DataKit As AddressFamily 
[JScript] public var DataKit : AddressFamily; 

Description 

Address for Datakit protocols. 

[C#] public const AddressFamily DataLink; 
[C++] public: const AddressFamily DataLink; 
[VB] Public Const DataLink As AddressFamily 
[JScript] public var DataLink : AddressFamily; 

Description 

Direct data-link interface address. 

[C#] public const AddressFamily DecNet; 
[C++] public: const AddressFamily DecNet; 
[VB] Public Const DecNet As AddressFamily 
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[JScript] public var DecNet : AddressFamily; 

3 Description 

4 DECnet address. 
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[C#] public const AddressFamily Ecma; 
[C++] public: const AddressFamily Ecma; 
[VB] Public Const Ecma As AddressFamily 
[JScript] public var Ecma : AddressFamily; 

Description 

European Computer Manufacturers Association (ECMA) address. 

[C#] public const AddressFamily FireFox; 
[C++] public: const AddressFamily FireFox; 
[VB] Public Const FireFox As AddressFamily 
[JScript] public var FireFox : AddressFamily; 

Description 

FireFox address. 

[C#] public const AddressFamily HyperChannel; 
[C++] public: const AddressFamily HyperChannel; 
[VB] Public Const HyperChannel As AddressFamily 
[JScript] public var HyperChannel : AddressFamily; 
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Description 

NSC Hyperchannel address. 

[C#] public const AddressFamily Ieeel2844; 
[C++] public: const AddressFamily Ieeel2844; 
[VB] Public Const Ieeel2844 As AddressFamily 
[JScript] public var Ieeel2844 : AddressFamily; 

Description 

IEEE 1284,4 workgroup address. 

[C#] public const AddressFamily ImpLink; 
[C++] public: const AddressFamily ImpLink; 
[VB] Public Const ImpLink As AddressFamily 
[JScript] public var ImpLink : AddressFamily; 

Description 

ARPANET IMP address. 

[C#] public const AddressFamily InterNetwork; 
[C++] public: const AddressFamily InterNetwork; 
[ VB] Public Const InterNetwork As AddressFamily 
[JScript] public var InterNetwork : AddressFamily; 
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Description 

Address for IP version 4. 

[C#] public const AddressFamily InterNetworkV6; 
[C++] public: const AddressFamily InterNetworkV6; 
[VB] Public Const InterNetworkV6 As AddressFamily 
[JScript] public var InterNetworkV6 : AddressFamily; 

10 Description 

11 Address for IP version 6. 

12 

13 [C#] public const AddressFamily Ipx; 

14 [C++] public: const AddressFamily Ipx; 

15 [VB] Public Const Ipx As AddressFamily 
[JScript] public var Ipx : AddressFamily; 



16 



17 
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Description 

IPX or SPX address. 

[C#] public const AddressFamily Irda; 
[C++] public: const AddressFamily Irda; 
[VB] Public Const Irda As AddressFamily 
[JScript] public var Irda : AddressFamily; 
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Description 

IrDA address. 

[C#] public const AddressFamily Iso; 
[C++] public: const AddressFamily Iso; 
[ VB] Public Const Iso As AddressFamily 
[JScript] public var Iso : AddressFamily; 

Description 

Address for ISO protocols. 

[C#] public const AddressFamily Lat; 
[C++] public: const AddressFamily Lat; 
[VB] Public Const Lat As AddressFamily 
[JScript] public var Lat : AddressFamily; 

Description 

LAT address. 

[C#] public const AddressFamily Max; 
[C++] public: const AddressFamily Max; 
[VB] Public Const Max As AddressFamily 
[JScript] public var Max : AddressFamily; 
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Description 

MAX address. 

[C#] public const AddressFamily NetBios; 
[C++] public: const AddressFamily NetBios; 
[VB] Public Const NetBios As AddressFamily 
[JScript] public var NetBios : AddressFamily; 

Description 

NetBios address. 

[C#] public const AddressFamily NetworkDesigners; 
[C++] public: const AddressFamily NetworkDesigners; 
[VB] Public Const NetworkDesigners As AddressFamily 
[JScript] public var NetworkDesigners : AddressFamily; 

Description 

Address for Network Designers OSI gateway-enabled protocols. 

[C#] public const AddressFamily NS; 
[C++] public: const AddressFamily NS; 
[VB] Public Const NS As AddressFamily 
[JScript] public var NS : AddressFamily; 
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Description 

Address for Xerox NS protocols. 

[C#] public const AddressFamily Osi; 
[C++] public: const AddressFamily Osi; 
[VB] Public Const Osi As AddressFamily 
[JScript] public var Osi : AddressFamily; 

Description 

Address for ISO protocols. 

[C#] public const AddressFamily Pup; 
[C++] public: const AddressFamily Pup; 
[VB] Public Const Pup As AddressFamily 
[JScript] public var Pup : AddressFamily; 

Description 

Address for PUP protocols. 

[C#] public const AddressFamily Sna; 
[C++] public: const AddressFamily Sna; 
[VB] Public Const Sna As AddressFamily 
[JScript] public var Sna : AddressFamily; 



lee@hayes piic s09.324.9z5s 



2199 



Description 

IBM SNA address. 

[C#] public const AddressFamily Unix; 
[C++] public: const AddressFamily Unix; 
[VB] Public Const Unix As AddressFamily 
[JScript] public var Unix : AddressFamily; 

Description 

Unix local to host address. 

[C#] public const AddressFamily Unknown; 
[C++] public: const AddressFamily Unknown; 
[VB] Public Const Unknown As AddressFamily 
[JScript] public var Unknown : AddressFamily; 

Description 

Unknown address family. 

[C#] public const AddressFamily Unspecified; 
[C++] public: const AddressFamily Unspecified; 
[VB] Public Const Unspecified As AddressFamily 
[JScript] public var Unspecified : AddressFamily; 
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Description 

Unspecified address family. 

[C#] public const AddressFamily VoiceView; 
[C++] public: const AddressFamily VoiceView; 
[ VB] Public Const VoiceView As AddressFamily 
[JScript] public var VoiceView : AddressFamily; 

Description 

VoiceView address. 
Methods: 

LingerOption class (System.Net.Sockets) 
ToString 



Description 

Contains information about a socket's linger time, the amount of time it will 
remain after closing if data remains to be sent. 

The settings of the System.NetSocketsXingerOption instance associated 
with a System.Net.Sockets.Socket instance control the length of time that a 
socket will remain after closing if data remains to be sent. 

Constructors: 

LingerOption 

Example Syntax: 
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ToString 



[C#] public LingerOption(bool enable, int seconds); 

[C++] public: LingerOption(bool enable, int seconds); 

[VB] Public Sub New(ByVal enable As Boolean, ByVal seconds As Integer) 

[JScript] public function LingerOption(enable : Boolean, seconds : int); 

Description 

Initializes a new instance of the System.Net-SocketsXingerOption class. 

The System.Net.Sockets.LingerOption instance is created with 
System.NetSocketsXingerOption.Enabled property set to enable and the 
System.NetSockets.LingerOption.LingerTime property set to seconds . true to 
enable remaining connected after System.Net*Sockets.Socket.Close is called; 
otherwise, false . The number of seconds to remain connected after 
System.Net*Sockets.Socket.Closeis called. 

Properties: 

Enabled 

ToString 

[C#] pubhc bool Enabled {get; set;} 

[C++] public: property bool get_Enabled();public: property void 

set_Enabled(bool) ; 

[VB] Public Property Enabled As Boolean 

[JScript] public fimction get Enabled() : Boolean;public ftmction set 
Enabled(Boolean); 
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Description 

Gets or sets a value indicating whether to linger after the socket is closed. 

LingerTime 

ToString 

[C#] public int LingerTime {get; set;} 

[C++] public: property int get_LingerTime();public: property void 

set_LingerTinie(int) ; 

[VB] Public Property LingerTime As Integer 

[JScript] public function get LingerTimeQ : int;public fiinction set 

LingerTime(int) ; 

Description 

Gets or sets the amount of time to remain connected after the socket is 

closed. 

MulticastOption class (System.Net. Sockets) 
ToString 

Description 

Contains IP address values for IP multicast packets. 

The System.Net.SocketsMulticastOption class sets IP address values 
when joining or leaving an IP multicast group. It is used with the 
System.Net.Sockets*Socket.SetSocketOption(System.Net.Sockets.SocketOptio 
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nLeveI,System,Net.Sockets.SocketOptionName,System.Int32) and 
System.Net.Sockets.Socket.GetSocketOption(System*Net.Sockets.SocketOptio 
iiLevel,System.Net.Sockets.SocketOptioiiName) methods when the optionName 
parameter is set to System^Net.Sockets.SocketOptionName.AddMembership or 
System.Net.Sockets-SocketOptioiiName.DropMembership . 

MulticastOption 

Example Syntax: 

ToString 

[C#] public MulticastOption(IP Address group); 

[C++] public: MulticastOption(IP Address* group); 

[VB] Public Sub New(ByVal group As IP Address) 

[JScript] public function MulticastOption(group : IP Address); 

Description 

Initializes a new version of the System.Net.Sockets.MulticastOption class 
for the specified IP multicast group. The IP address of the multicast group. 
MulticastOption 
Example Syntax: 
ToString 

[C#] public MulticastOption(IP Address group, IP Address mcint); 

[C++] public: MulticastOption(IP Address* group, IP Address* mcint); 

[VB] Public Sub New(ByVal group As IP Address, ByVal mcint As IPAddress) 

[JScript] public function MulticastOption(group : IPAddress, mcint : IPAddress); 
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Initializes anew instance of the System.Net.Sockets.MulticastOption class. 
Description 

Initializes a new instance of the System.Net.Sockets.MulticastOption 

class with the specified IP multicast group address and local interface address. The 
group IP address. The local IP address. 

Group 

ToString 

[C#] public IP Address Group {get; set;} 

[C++] public: __property IP Address* get_Group();public: _property void 

set_Group(IP Address*); 

[VB] Public Property Group As IP Address 

[JScript] public function get GroupQ : IPAddress;pubHc function set 
Group(IP Address); 

Description 

Gets or sets the IP address of a multicast group. 
VaUd IP addresses for multicast packets are in the range 224.0.0.0 to 
239.255.255.255. 

LocalAddress 
ToString 

[C#] public IP Address LocalAddress {get; set;} 

[C++] public: _property IP Address* get_LocalAddress();public: _property void 
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set_LocalAddress(IP Address*); 

[VB] Public Property LocalAddress As IP Address 

[JScript] public function get LocalAddressQ : IPAddress;public function set 
LocalAddress(IP Address); 

Description 

Gets or sets the local address associated with a multicast group. 

The System.Net.Sockets.MuIticastOption.LocalAddress property 
contains the IP address of the interface associated with the multicast group 
membership. If System.Net.Sockets.MulticastOption.LocalAddress is set to 
System.Net.IPAddress.Any , the default interface is used. 

NetworkStream class (System.Net.Sockets) 

ToString 



Description 

Provides the underlying stream of data for network access. 
System.Net.Sockets.NetworkStream implements the standard .NET 
Framework stream mechanism to send and receive data through network sockets. 
NetworkStream 
Example Syntax: 
ToString 

[C#] pubUc NetworkStream(Socket socket); 
[C++] public: NetworkStream(Socket* socket); 
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[VB] Public Sub New(ByVal socket As Socket) 

[JScript] public function NetworkStream(socket : Socket); Creates a new instance 
of the System.Net.Sockets.NetworkStream class. 

Description 

Creates anew instance of the System,NetSockets.NetworkStream class 
for the specified System.Net.Sockets.Socket . 

The System.NetSockets.NetworkStream is created with read/write access 
to the specified socket. The System.Net.Sockets.NetworkStream does not own 
the underlying socket, so calling the System.Net.Sockets.NetworkStream.Close 
method will not close the socket. The System.Net.Sockets.Socket that provides 
the network data for the new System.Net.Sockets.NetworkStream . 

NetworkStream 

Example Syntax: 

ToString 

[C#] public NetworkStream(Socket socket, bool ownsSocket); 

[C^+l public: NetworkStream(Socket* socket, bool ownsSocket); 

[VB] Public Sub New(ByVal socket As Socket, ByVal ownsSocket As Boolean) 

[JScript] public fiinction NetworkStream(socket : Socket, ownsSocket : Boolean); 

Description 

Initiahzes a new instance of the System.Net.Sockets.NetworkStream class 
for the specified socket with the specified System.Net.Sockets.Socket ownership. 
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The System.Net.Sockets.NetworkStream is created with read/write access 
to the specified socket. If ownsSocket is true , the 

System.Net.Sockets.NetworkStream owns the underlying socket, and calling 
System.Net.Sockets.NetworkStream.Close will also close the underlying socket. 
The network socket that the new System.Net.Sockets.NetworkStream will 
encapsulate, true if the socket will be owned by this 
System.Net.Sockets.NetworkStream instance; otherwise, false. 

NetworkStream 

Example Syntax: 

ToString 

[C#l public NetworkStream(Socket socket, FileAccess access); 

[C++] public: NetworkStream(Socket* socket, FileAccess access); 

[VB] Public Sub New(ByVal socket As Socket, ByVal access As FileAccess) 

[JScript] public function NetworkStream(socket : Socket, access : FileAccess); 

Description 

Creates a new instance of the System.Net.Sockets.NetworkStream class 
for the specified System.Net.Sockets.Socket with the specified access rights. 

The System.Net.Sockets.NetworkStream is created with the specified 
access to the specified socket. The System.Net.Sockets.NetworkStream does not 
own the underlying socket, so calling the 

System.Net.Sockets.NetworkStream.Close method will not close the socket. The 
System.Net.Sockets.Socket that provides the network data. One of the 
System.IO.FileAccess values that sets the 
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System.Net.Sockets,NetworkStream*CanRead and 
System.Net.Sockets^NetworkStream.CanWrite properties of the 
System.Net.Sockets*NetworkStream . 

NetworkStream 
Example Syntax: 
ToString 

[C#] public NetworkStream(Socket socket, FileAccess access, bool ownsSocket); 
[C++] public: NetworkStream(Socket* socket, FileAccess access, bool 
ownsSocket); 

[VB] Public Sub New(ByVal socket As Socket, ByVal access As FileAccess, 
ByVal ownsSocket As Boolean) 

[JScript] public function NetworkStream(socket : Socket, access : FileAccess, 
ownsSocket : Boolean); 

Description 

Creates anew instance of the System.Net.Sockets.NetworkStream class 
for the specified Systein.Net.Sockets.Socket with the specified access rights and 
the specified System»Net.Sockets.Socket ownership. 

The System.Net.Sockets.NetworkStream is created with the specifed 
access to the specified socket. If ownsSocket is true , the 
System.Net.Sockets.NetworkStream owns the underlying socket, and calling 
System.Net.Sockets.NetworkStream.Close will also close the underlying socket. 
The System.Net.Sockets.Socket that provides the network data. One of the 
System.IO^FileAccess values that sets the 
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System.Net.Sockets.NetworkStream.CanReadand 
System.Net.Sockets.NetworkStream.CanWrite properties of the 
System.Net.Sockets.NetworkStreani . true if the socket will be owned by this 
System.Net.Sockets.NetworkStream instance; otherwise, false. 

CanRead 
ToString 

[C#] public override bool CanRead {get;} 

[C++] public: property virtual bool get_CanRead(); 

[VB] Overrides Public ReadOnly Property CanRead As Boolean 

[JScript] public function get CanRead() : Boolean; 

Description 

Gets a value indicating whether the current stream supports reading. 

CanSeek 

ToString 

[C#] public override bool CanSeek {get;} 

[C++] public: property virtual bool get_CanSeek(); 

[VB] Overrides PubHc ReadOnly Property CanSeek As Boolean 
[JScript] pubHc function get CanSeekQ : Boolean; 

Description 

Gets a value indicating whether the stream supports seeking. This property 
always returns false . 
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CanWrite 
ToString 

[C#] public override bool CanWrite {get;} 

[C++] public: property virtual bool get CanWriteQ; 

[VB] Overrides Public ReadOnly Property CanWrite As Boolean 
[JScript] public function get CanWriteQ : Boolean; 

Description 

Gets a value that indicates whether the current stream supports writing. 

DataAvailable 

ToString 

[C#] public virtual bool DataAvailable {get;} 

[C++] public: property virtual bool get_DataAvailable(); 

[VB] Overridable Public ReadOnly Property DataAvailable As Boolean 

[JScript] public function get DataAvailable() : Boolean; 

Description 

Gets a value indicating whether data is available on the stream to be read. 

Length 

ToString 

[C#] public override long Length {get;} 

[C++] public: property virtual ^int64 get_Length(); 
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[VB] Overrides Public ReadOnly Property Length As Long 
[JScript] public function get Length() : long; 

Description 

The length of the data available on the stream. This property always throws 
a System.NotSupportedExceptioii . 
Position 
ToString 

[C#] public override long Position {get; set;} 

[C++] public: property virtual int64 get_Position();public: property virtual 

void set_Position( int64); 

[VB] Overrides Public Property Position As Long 

[JScript] public function get PositionQ : long;public function set Position(long); 
Description 

Gets or sets the current position in the stream. This property always throws 
a System.NotSupportedException . 
Readable 
ToString 

[C#] protected bool Readable {get; set;} 

[C++] protected: property bool get_Readable();protected: property void 

set_Readable(booI); 

[VB] Protected Property Readable As Boolean 
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[JScript] protected function get Readable() : Boolean;protected function set 
Readable(Boolean); 

Description 

Gets or sets a value indicating that the stream can be read. 

The System.Net.Sockets.NetworkStream.Readable property is accessible 
only through this class or a derived class. Other classes can determine whether a 
System.NetSockets.NetworkStream is readable by checking the 
System*Net.Sockets»NetworkStream.CanRead property. 

Socket 

ToString 

[C#] protected Socket Socket {get;} 

[C++] protected: property Socket* get_Socket(); 

[VB] Protected ReadOnly Property Socket As Socket 
[JScript] protected function get Socket() : Socket; 

Description 

Gets the underlying network connection. 

The System.Net.Sockets.NetworkStream.Socket property represents the 
underlying network socket that this System.Net.Sockets.NetworkStream 

encapsulates. 

Writeable 
ToString 
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[C#] protected bool Writeable {get; set;} 

[C++] protected: _property bool get_Writeable();protected: _property void 
set_Writeable(bool); 

[VB] Protected Property Writeable As Boolean 

[JScript] protected function get WriteableQ : Boolean;protected function set 
Writeable(Boolean); 

Description 

Gets a value that indicates whether the stream is writable. 

The System.Net.Sockets.NetworkStreain.Writeable property is 
accessible only through this class or a derived class. Other classes can determine 
whether a System.Net.Sockets.NetworkStream is writable by checking the 
System.Net.Sockets.NetworkStream.CanWrite property. 

BeginRead 

[C#] pubhc override lAsyncResult BeginRead(byte[] buffer, int offset, int size, 
AsyncCallback callback, object state); 

[C++] public: lAsyncResult* BeginRead(unsigned char buffer _gc[], int offset, 
int size, AsyncCallback* callback, Object* state); 

[VB] Overrides Pubhc Function BeginRead(ByVal bufferQ As Byte, ByVal offset 
As Integer, ByVal size As Integer, ByVal callback As AsyncCallback, ByVal state 
As Object) As lAsyncResult 

[JScript] pubhc override function BeginRead(buffer : Byte[], offset : int, size : int, 
callback : AsyncCallback, state : Object) : lAsyncResult; 
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Description 

Begins an asynchronous read from a stream. 
Return Value: An System.IAsyncResult representing the asynchronous call. 

The 

System*NetSockets.NetworkStream.BeginRead(System.Byte[l,SysteinJiit32,S 
ystem.Int325System.AsyncCallback5System.Object) method begins an 
asynchronous request for data from a network stream. The method that 
implements the SystemAsyncCallback delegate uses the 
System.Net.Sockets.NetworkStreaiii.EndRead(SystemJAsyncResult) method 
to retum the amount of data read from the stream. The location in memory that 
stores the data from the stream. The location in buffer to begin storing the data to. 
The size of buffer . The delegate to call when the asynchronous call is complete. 
An object containing additional information supplied by the client. 
BeginWrite 

[C#] public override lAsyncResult BeginWrite(byte[] buffer, int offset, int size, 
AsyncCallback callback, object state); 

[C++] public: lAsyncResult'*' BeginWrite(unsigned char buffer gc[], int offset, 

int size, AsyncCallback* callback, Object* state); 

[ VB] Overrides Public Function Begin Write(ByVal bufferQ As Byte, ByVal offset 
As Integer, ByVal size As Integer, ByVal callback As AsyncCallback, ByVal state 
As Object) As lAsyncResult 

[JScript] public override function Begin Write(buffer : B5^e[], offset : int, size : int, 
callback : AsyncCallback, state : Object) : lAsyncResult; 
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Description 

Begins an asynchronous write to a stream. 
Return Value: An System.IAsyncResult representing the asynchronous call. 

The 

System.NetSockets.NetworkStream.BegmWrite(System.Byte[],System.Iiit32, 
System.Iiit32,System.AsyncCallback,System.Object) method begins to send 
data asynchronously to the network stream. The method that implements the 
System.AsyncCallback delegate uses the 

System.NetSockets.NetworkStream.EndRead(SystemJAsyncResult) method 
to complete sending the data. The location in memory that holds the data to send. 
The location in buffer to begin sending the data. The size of buffer . The delegate 
to call when the asynchronous call is complete. An object containing additional 
information supplied by the client. 
Close 

[C#] pubHc override void CloseQ; 
[C++] public: void CloseQ; 
[VB] Overrides Public Sub CloseQ 
[JScript] public override function CloseQ; 

Description 

Closes the stream and optionally closes the underlying socket. 
The System^Net.Sockets.NetworkStream.Close method frees resources 
used by the System.Net^Sockets.NetworkStream instance and, if the 
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System.Net.Sockets.NetworkStream owns the underlying socket, closes the 
underlying socket. 
Dispose 

[C#] protected virtual void Dispose(bool disposing); 

[C++] protected: virtual void Dispose(bool disposing); 

[ VB] Overridable Protected Sub Dispose(ByVal disposing As Boolean) 

[JScript] protected function Dispose(disposing : Boolean); 

Description 

Cleans up a network stream, true if this method was called by another 
method such as System.NetSockets.NetworkStream.Close or 
System.NetSockets.NetworkStream.Dispose(System.Boolean); false if this 
method was called by the finalizer. 

EndRead 

[C#] public override int EndRead(IAsyncResult asyncResult); 

[C++] public: int EndRead(IAsyncResult'^ asyncResult); 

[ VB] Overrides Public Function EndRead(ByVal asyncResult As I AsyncResult) 

As Integer 

[JScript] public override function EndRead(asyncResult : lAsyncResult) : int; 

Description 

Handles the end of an asynchronous read. 
Return Value: The number of bytes read from the stream. 
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The 

System.Net.Sockets.NetworkStream.EndRead(System.IAsyncResult) method 
completes an asynchronous read of the network stream started with the 
System.Net.Sockets.NetworkStream.BegmRead(Systeiii.Byte[],SystemJiit32,S 
ystem.Int32,System.AsyncCallback,System.Object) method. An 
System.IAsyncResult representing an asynchronous call. 
EndWrite 

[C#] public override void EndWrite(IAsyncResult asyncResult); 

[C++] pubKc: void EndWrite(IAsyncResult* asyncResult); 

[VB] Overrides Public Sub EndWrite(ByVal asyncResult As lAsyncResult) 

[JScript] public override function EndWrite(asyncResult : I AsyncResult); 

Description 

Handles the end of an asynchronous write. 
The 

System.Net»Sockets.NetworkStream.EndWrite(System.IAsyncResult) method 
completes an asynchronous write to a network stream started with the 
System.Net.Sockets.NetworkStream.BegmWrite(System.Byte[],System.Int32, 
System.Int32,SystemAsyncCallback,System.Object) method. The 
SystemJAsyncResult representing the asynchronous call. 
Finalize 

[C#] -NetworkStreamO; 
[C++] -NetworkStreamO; 
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[VB] Overrides Protected Sub FinalizeQ 
[JScript] protected override function FinalizeQ; 

Description 

Frees resources used by the System.Net.Sockets.NetworkStream . 
The System.Net.Sockets.NetworkStreara finalizer calls the 
System.Net.Sockets*NetworkStream*Close method to close the stream. 
Flush 

[C#] public override void Flush(); 
[C++] public: void FlushQ; 
[VB] Overrides Public Sub FlushQ 
[JScript] public override function FlushQ; 

Description 

Flushes data from the stream. This method is reserved for future use. 
The System.Net.Sockets.NetworkStream.Flush method implements the 
System.IO.Stream.Flush method but, because 

System.Net.Sockets.NetworkStream is not buffered, has no effect on network 
streams. Calling the System.Net^Sockets.NetworkStream.Flush method will not 
throw an exception. 
Read 

[C#] public override int Read(in byte[] buffer, int offset, int size); 

[C++] public: int Read( in unsigned char"^ buffer gc[], int offset, int size); 
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[VB] Overrides Public Function Read(ByVal bufferQ As Byte, ByVal offset As 
Integer, ByVal size As Integer) As Integer 

[JScript] public override function Read(in buffer : Byte[], offset : int, size : int) : 
int; 

Description 

Reads data from the stream. 
Return Value: The number of bytes read from the stream. 

The 

System.Net.Sockets.NetworkStream,Read(System.Byte[],System.Int32,System 
Jnt32) method reads data from the network stream into a data buffer. The location 
in memory to store data read from the stream. The location in the buffer to begin 
storing the data to. The number of bytes to read from the stream. 
Seek 

[C#] pubUc override long Seek(long offset, SeekOrigin origin); 

[C++] public: _int64 Seek(_int64 offset, SeekOrigin origin); 

[VB] Overrides Public Function Seek(ByVal offset As Long, ByVal origin As 

SeekOrigin) As Long 

[JScript] pubhc override function Seek(offset : long, origin : SeekOrigin) : long; 

Description 

Sets the current position of the stream to the given value. This method 
always throws a System.NotSupportedException . This parameter is not used. 
This parameter is not used. 
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SetLength 

[C#] public override void SetLength(long value); 

[C++] public: void SetLength( int64 value); 

[VB] Overrides Public Sub SetLength(ByVal value As Long) 
[JScript] public override function SetLength(value : long); 

Description 

Sets the length of the stream. This method always throws a 
System.NotSupportedException . This parameter is not used. 
IDisposable.Dispose 

[C#] void IDisposable.DisposeQ; 
[C++] void IDisposable::Dispose(); 
[VB] Sub DisposeO Implements IDisposable.Dispose 
[JScript] function IDisposable.Dispose(); 
Write 

[C#] public override void Write(byte[] buffer, int offset, int size); 

[C++] public: void Write(unsigned char buffer gc[], int offset, int size); 

[ VB] Overrides PubHc Sub Write(ByVal bufferQ As Byte, ByVal offset As 
Integer, ByVal size As Integer) 

[JScript] public override function Write(buffer : Byte[], offset : int, size : int); 
Description 
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Writes data to the stream. 
Return Value: The number of bytes written to the stream. 
The 

System.Net.Sockets.NetworkStream.Write(System.Byte[]9SystemJnt325Syste 
m.Iiit32) method sends the contents of a data buffer to the network. The data to 
write to the stream. The location in the buffer to start writing data from. The 
number of bytes to write to the stream. 

ProtocoIFamily enumeration (System.Net.Sockets) 

WriteByte 

Description 

Specifies the type of protocol that an instance of the 
System,Net.Sockets.Socket class can use. 

The System^Net.Sockets.ProtocolFamily enumeration specifies the 
protocol scheme used by the System.Net,Sockets.Socket class to resolve an 
address. For example, System.Net.Sockets^ProtocolFamily.InterNetwork 
indicates that the IP version 4 protocol is expected when a 
System.NetSockets.Socket connects to an endpoint. 

WriteByte 

[C#] public const ProtocoIFamily AppIeTalk; 
[C++] public: const ProtocoIFamily AppIeTalk; 
[ VB] Public Const AppIeTalk As ProtocoIFamily 
[ JScript] public var AppIeTalk : ProtocoIFamily; 



lee@hayes piic s09.324.9i56 



2222 



M51'862US,APP 



Description 

AppleTalk protocol. 
WriteByte 

[C#] public const ProtocolFamily Atm; 
[C++] public: const ProtocolFamily Atm; 
[VB] Public Const Atm As ProtocolFamily 
[JScript] public var Atm : ProtocolFamily; 

Description 

Native ATM services protocol. 
WriteByte 

[C#] public const ProtocolFamily Banyan; 
[C++] public: const ProtocolFamily Banyan; 
[VB] Public Const Banyan As ProtocolFamily 
[JScript] public var Banyan : ProtocolFamily; 

Description 

Banyan protocol. 
WriteByte 

[C#] public const ProtocolFamily Ccitt; 
[C++] public: const ProtocolFamily Ccitt; 
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[VB] Public Const Ccitt As ProtocolFamily 
[JScript] public var Ccitt : ProtocolFamily; 

Description 

CCITT protocol, such as X.25. 
WriteByte 

[C#] public const ProtocolFamily Chaos; 
[C++] pubHc: const ProtocolFamily Chaos; 
[VB] Public Const Chaos As ProtocolFamily 
[JScript] public var Chaos : ProtocolFamily; 

Description 

MIT CHAOS protocol. 
WriteByte 

[C#] public const ProtocolFamily Cluster; 
[C++] public: const ProtocolFamily Cluster; 
[ VB] Pubhc Const Cluster As ProtocolFamily 
[JScript] public var Cluster : ProtocolFamily; 

Description 

Microsoft Cluster products protocol. 
WriteByte 
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[C#] public const ProtocolFamily DataKit; 
[C++] public: const ProtocolFamily DataKit; 
[VB] Public Const DataKit As ProtocolFamily 
[JScript] public var DataKit : ProtocolFamily; 

Description 

DataKit protocol. 
WriteByte 

[C#] public const ProtocolFamily DataLink; 
[C++] public: const ProtocolFamily DataLink; 
[ VB] Public Const DataLink As ProtocolFamily 
[JScript] public var DataLink : ProtocolFamily; 

Description 

Direct data link protocol. 
WriteByte 

[C#] public const ProtocolFamily DecNet; 
[C++] public: const ProtocolFamily DecNet; 
[ VB] Public Const DecNet As ProtocolFamily 
[JScript] public var DecNet : ProtocolFamily; 

Description 
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DECNet protocol. 
WriteByte 

[C#] public const ProtocolFamily Ecma; 
[C++] public: const ProtocolFamily Ecma; 
[VB] Public Const Ecma As ProtocolFamily 
[ JScript] public var Ecma : ProtocolFamily; 

Description 

European Computer Manufactures Association (ECMA) protocol. 
WriteByte 

[C#] public const ProtocolFamily FireFox; 
[C++] public: const ProtocolFamily FireFox; 
[ VB] Public Const FireFox As ProtocolFamily 
[JScript] public var FireFox : ProtocolFamily; 

Description 

FireFox protocol. 
WriteByte 

[C#] public const ProtocolFamily HyperChannel; 
[C++] public: const ProtocolFamily HyperChannel; 
[ VB] Public Const HyperChannel As ProtocolFamily 
[JScript] public var HyperChannel : ProtocolFamily; 
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Description 

NSC HyperChannel protocol. 
WriteByte 

[C#] public const ProtocolFamily leee 12844; 
[C++] public: const ProtocolFamily Ieeel2844; 
[VB] Public Const Ieeel2844 As ProtocolFamily 
[JScript] public var leee 12844 : ProtocolFamily; 

Description 

IEEE 1284.4 workgroup protocol. 
WriteByte 

[C#] public const ProtocolFamily ImpLink; 
[C++] public: const ProtocolFamily ImpLink; 
[ VB] Public Const ImpLink As ProtocolFamily 
[JScript] public var ImpLink : ProtocolFamily; 

Description 

ARPANET IMP protocol. 
WriteByte 

[C#] public const ProtocolFamily InterNetwork; 
[C++] public: const ProtocolFamily InterNetwork; 
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[VB] Public Const InterNetwork As ProtocolFamily 
[JScript] public var InterNetwork : ProtocolFamily; 

Description 

IP version 4 protocol. 
WriteByte 

[C#] public const ProtocolFamily InterNetworkV6; 
[C++] public: const ProtocolFamily InterNetworkV6; 
[VB] Public Const InterNetworkV6 As ProtocolFamily 
[JScript] public var InterNetworkV6 : ProtocolFamily; 

Description 

IP version 6 protocol. 
WriteByte 

[C#] public const ProtocolFamily Ipx; 
[C++] public: const ProtocolFamily Ipx; 
[VB] Public Const Ipx As ProtocolFamily 
[JScript] public var Ipx : ProtocolFamily; 

Description 

IPX or SPX protocol. 
WriteByte 
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[C#] public const ProtocolFamily Irda; 
[C++] public: const ProtocolFamily Irda; 
[VB] Public Const Irda As ProtocolFamily 
[JScript] public var Irda : ProtocolFamily; 

Description 

IrDA protocol. 
WriteByte 

[C#] public const ProtocolFamily Iso; 
[C++] public: const ProtocolFamily Iso; 
[VB] Public Const Iso As ProtocolFamily 
[JScript] public var Iso : ProtocolFamily; 

Description 

ISO protocol. 
WriteByte 

[C#] public const ProtocolFamily Lat; 
[C++] public: const ProtocolFamily Lat; 
[VB] Public Const Lat As ProtocolFamily 
[JScript] public var Lat : ProtocolFamily; 

Description 
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LAT protocol 
WriteByte 

[C#] public const ProtocolFamily Max; 
[C++] public: const ProtocolFamily Max; 
[VB] Public Const Max As ProtocolFamily 
[JScript] public var Max : ProtocolFamily; 

Description 

MAX protocol. 
WriteByte 

[C#] public const ProtocolFamily NetBios; 
[C++] public: const ProtocolFamily NetBios; 
[VB] Public Const NetBios As ProtocolFamily 
[JScript] public var NetBios : ProtocolFamily; 

Description 

NetBios protocol. 
WriteByte 

[C#] public const ProtocolFamily NetworkDesigners; 
[C++] public: const ProtocolFamily NetworkDesigners; 
[VB] Public Const NetworkDesigners As ProtocolFamily 
[JScript] public var NetworkDesigners : ProtocolFamily; 
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Description 

Network Designers OSI gateway enabled protocol. 
WriteByte 

[C#] public const ProtocolFamily NS; 
[C++] public: const ProtocolFamily NS; 
[VB] Public Const NS As ProtocolFamily 
[JScript] public var NS : ProtocolFamily; 

10 

11 Description 

12 Xerox NS protocol. 

13 WriteByte 
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[C#] public const ProtocolFamily Osi; 
[C++] public: const ProtocolFamily Osi; 
[VB] Public Const Osi As ProtocolFamily 
[JScript] public var Osi : ProtocolFamily; 

Description 

OSI protocol. 
WriteByte 

[C#] public const ProtocolFamily Pup; 
[C++] public: const ProtocolFamily Pup; 
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[VB] Public Const Pup As ProtocolFamily 
[ JScript] public var Pup : ProtocolFamily; 

Description 

PUP protocol 
WriteByte 

[C#] public const ProtocolFamily Sna; 
[C++] public: const ProtocolFamily Sna; 
[VB] Public Const Sna As ProtocolFamily 
[JScript] public var Sna : ProtocolFamily; 

Description 

IBM SNA protocol 
WriteByte 

[C#] public const ProtocolFamily Unix; 
[C++] public: const ProtocolFamily Unix; 
[VB] Public Const Unix As ProtocolFamily 
[JScript] public var Unix : ProtocolFamily; 

Description 

Unix local to host protocol 
WriteByte 
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[C#] public const ProtocolFamily Unknown; 
[C++] public: const ProtocolFamily Unknown; 
[VB] Public Const Unknown As ProtocolFamily 
[JScript] public var Unknown : ProtocolFamily; 

Description 

Unknown protocol. 
WriteByte 

[C#] public const ProtocolFamily Unspecified; 
[C++] public: const ProtocolFamily Unspecified; 
[VB] Public Const Unspecified As ProtocolFamily 
[JScript] public var Unspecified : ProtocolFamily; 

Description 

Unspecified protocol. 
WriteByte 

[C#] public const ProtocolFamily VoiceView; 
[C++] public: const ProtocolFamily VoiceView; 
[VB] Public Const VoiceView As ProtocolFamily 
[JScript] public var VoiceView : ProtocolFamily; 

Description 
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VoiceView protocol. 

ProtocolType enumeration (System.Net.Sockets) 
ToString 

Description 

Specifies the protocols that the System.Net.Sockets.Socket class supports. 

The System,Net.Sockets*ProtocolType enumeration is used by the 
System.Net»Sockets*Socket class to indicate to the Windows Socket API the 
requested protocol for the socket. Low-level driver software for the requested 
protocol must be present on the computer for the System.Net.Sockets.Socket to 
be created. 

ToString 

[C#] public const ProtocolType Ggp; 
[C++] public: const ProtocolType Ggp; 
[VB] Public Const Ggp As ProtocolType 
[JScript] public var Ggp : ProtocolType; 

Description 

Gateway To Gateway Protocol. 
ToString 

[C#] public const ProtocolType Icmp; 
[C++] public: const ProtocolType Icmp; 
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[VB] Public Const Icmp As ProtocolType 
[JScript] public var Icmp : ProtocolType; 

Description 

Internet Control Message Protocol. 
ToString 

[C#] public const ProtocolType Idp; 
[C++] public: const ProtocolType Idp; 
[VB] Public Const Idp As ProtocolType 
[JScript] public var Idp : ProtocolType; 

Description 

IDP Protocol. 
ToString 

[C#] public const ProtocolType Igmp; 
[C++] public: const ProtocolType Igmp; 
[VB] Public Const Igmp As ProtocolType 
[JScript] public var Igmp : ProtocolType; 

Description 

Internet Group Management Protocol. 
ToString 
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[C#] public const ProtocolType IP; 
[C++] public: const ProtocolType IP; 
[ VB] Public Const IP As ProtocolType 
[ JScript] public vat IP : ProtocolType; 

Description 

Internet Protocol. 
ToString 

[C#] public const ProtocolType Ipx; 
[C++] public: const ProtocolType Ipx; 
[ VB] Public Const Ipx As ProtocolType 
[JScript] public var Ipx : ProtocolType; 

Description 

IPX Protocol. 
ToString 

[C#] public const ProtocolType ND; 
[C++] public: const ProtocolType ND; 
[ VB] Public Const ND As ProtocolType 
[JScript] public var ND : ProtocolType; 

Description 
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Net Disk Protocol (unofficial). 
ToString 

[C#] public const ProtocolType Pup; 
[C++] public: const ProtocolType Pup; 
[VB] Public Const Pup As ProtocolType 
[JScript] public var Pup : ProtocolType; 

Description 

PUP Protocol. 
ToString 

[C#] public const ProtocolType Raw; 
[C++] public: const ProtocolType Raw; 
[VB] Public Const Raw As ProtocolType 
[JScript] public var Raw : ProtocolType; 

Description 

Raw UP packet protocol. 
ToString 

[C#] public const ProtocolType Spx; 
[C++] public: const ProtocolType Spx; 
[VB] Public Const Spx As ProtocolType 
[JScript] public var Spx : ProtocolType; 
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Description 

SPX Protocol. 
ToString 

6 [C#] public const ProtocolType SpxII; 

7 [C++] public: const ProtocolType SpxII; 
[VB] Public Const SpxII As ProtocolType 
[JScript] public var SpxII : ProtocolType; 

10 

11 Description 

12 SPX Version 2 Protocol. 

13 ToString 

14 

15 [C#] public const ProtocolType Tcp; 

16 [C++] public: const ProtocolType Tcp; 

17 [VB] Public Const Tcp As ProtocolType 
[JScript] public var Tcp : ProtocolType; 

19 

20 Description 

21 Transmission Control Protocol. 

22 ToString 

23 

24 [C#] public const ProtocolType Udp; 

25 [C++] public; const ProtocolType Udp; 
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[VB] Public Const Udp As ProtocolType 
[JScript] public var Udp : ProtocolType; 

Description 

User Datagram Protocol. 
ToString 

[C#] public const ProtocolType Unknown; 
[C++] public: const ProtocolType Unknown; 
[VB] Public Const Unknown As ProtocolType 
[JScript] public var Unknown : ProtocolType; 

Description 

Unknown protocol. 
ToString 

[C#] public const ProtocolType Unspecified; 
[C++] public: const ProtocolType Unspecified; 
[VB] Public Const Unspecified As ProtocolType 
[JScript] public var Unspecified : ProtocolType; 

Description 

Unspecified protocol. 

SelectMode enumeration (System.Net. Sockets) 
ToString 
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Description 

Defines the polling modes for the 
System.Net.Sockets.Socket.Poll(SysteniJnt32,System.Net.Sockets.SeIectMo 
) method. 

The Systeiii^Net.Sockets.SelectMode enumeration defines the polling 
modes that can be passed to the 

System.NetSockets-Socket.Poll(SystemJnt32,System.Net,Sockets.SelectMode 

) method. 

ToString 

[C#] public const SelectMode SelectError; 
[C++] public: const SelectMode SelectError; 
[VB] Public Const SelectError As SelectMode 
[JScript] public var SelectError : SelectMode; 

Description 

Error status mode. 
ToString 

[C#] public const SelectMode SelectRead; 
[C++] public: const SelectMode SelectRead; 
[ VB] PubHc Const SelectRead As SelectMode 
[JScript] public var SelectRead : SelectMode; 
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2 II Description 

Read status mode. 
ToString 

6 II [C#] public const SelectMode SelectWrite; 
[C++] public: const SelectMode SelectWrite; 
[VB] Public Const SelectWrite As SelectMode 
9 II [JScript] public var SelectWrite : SelectMode; 

10 

11 ll Description 
12 1 1 Write status mode. 

13 Socket class (System.Net.Sockets) 

14 I ToString 

15 
16 

17 j Description 

18 II Implements the Berkeley sockets interface. 

The System.NetSockets.Socket class creates a managed version of an 
Internet transport service. Once the socket is created, it is bound to a specific 
endpoint through the System-Net.Sockets.Socket.Bincl(System.NetEndPoiiit) 
method, and the connection to that endpoint is established through the 
23 II System.Net.Sockets.Socket.Connect(System.Net.EndPoint) method. 

24 II Socket 
25 Example Syntax: 
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ToString 

[C#] public Socket(AddressFamily addressFamily, SocketType socketType, 
ProtocolType protocolType); 

[C++] public: Socket(AddressFamily addressFamily, SocketType socketType, 
ProtocolType protocolType); 

[VB] Public Sub New(ByVal addressFamily As AddressFamily, ByVal 
socketType As SocketType, ByVal protocolType As ProtocolType) 
[JScript] public function Socket(addressFamily : AddressFamily, socketType : 
SocketType, protocolType : ProtocolType); 

Description 

Initializes a new instance of the System.Net.Sockets. Socket class. 

The addressFamily parameter specifies the addressing scheme that the 
socket uses, the socketType parameter specifies the type of the socket, and the 
protocolType parameter specifies the protocol used by the socket. The three 
parameters are not independent. Some address families restrict which protocols 
can be used with them, and often the socket type is implicit in the protocol. If the 
combination of address family, socket type, and protocol type results in an invahd 
socket, a System.Net.Sockets.SocketExceptioii is thrown. One of the 
System.Net.Sockets.AddressFamily values. One of the 
System.Net.Sockets.SocketType values. One of the 
Sy stein.Net.Sockets.ProtocolType values 

AddressFamily 
ToString 
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[C#] public AddressFamily AddressFamily {get;} 

[C++] public: property AddressFamily get_AddressFamilyO; 

[VB] Public Readonly Property AddressFamily As AddressFamily 
[JScript] public fimction get AddressFamilyQ : AddressFamily; 

Description 

Gets the address family of the socket. 

Available 

ToString 

[C#] public int Available {get;} 

[C++] public: _property int get_Available(); 

[VB] Public Readonly Property Available As Integer 

[JScript] public function get AvailableQ : int; 

Description 

Gets the amount of data that has been received from the network and 
available to be read. 
Blocking 
ToString 

[C#] pubhc bool Blocking {get; set;} 

[C++] public: property bool get_Blocking();public: property void 
set_Blocking(bool); 
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[VB] Public Property Blocking As Boolean 

[JScript] public function get Blocking() : Boolean;public function set 
Blocking(Boolean); 

Description 

Gets or sets a value that indicates whether the socket is in blocking mode. 
The System*Net.Sockets.Socket*Blocking property indicates whether a 
System,Net.Sockets.Socket is in blocking mode. 
Connected 
ToString 

[C#] pubhc bool Connected {get;} 

[C++] public: property bool get_Connected(); 

[VB] Public Readonly Property Connected As Boolean 
[JScript] public function get ConnectedQ : Boolean; 

Description 

Gets a value indicating whether a socket is connected to a remote resource. 

System.Net.Sockets.SocketConnected returns true if the socket has 
either connected to a remote resource or accepted a connection from a remote 
resource. 

Handle 

ToString 

[C#] public IntPtr Handle {get;} 
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[C++] public: property IntPtr get_Handle(); 

[VB] Public Readonly Property Handle As IntPtr 
[JScript] public function get HandleQ : IntPtr; 

Description 

Gets the operating system handle for the socket. 

LocalEndPoint 

ToString 

[C#] public EndPoint LocalEndPoint {get;} 

[C++] public: property EndPoint* get_LocalEndPoint(); 

[VB] Public Readonly Property LocalEndPoint As EndPoint 
[JScript] pubHc function get LocalEndPoint() : EndPoint; 

Description 

Gets the local endpoint. 

The System.Net.Sockets.Socket.LocalEndPoiiit property contains the 
network connection information associated with the local network device. 
ProtocolType 
ToString 

[C#] public ProtocolType ProtocolType {get;} 

[C++] public: property ProtocolType get ProtocolTypeQ; 

[VB] Public Readonly Property ProtocolType As ProtocolType 
[JScript] pubHc function get ProtocolType() : ProtocolType; 
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Description 

Gets the protocol type of the socket. 

RemoteEndPoint 

ToString 

[C#] pubhc EndPoint RemoteEndPoint {get;} 

[C++] pubhc: property EndPoint"^ get_RemoteEndPoint(); 

[VB] Pubhc Readonly Property RemoteEndPoint As EndPoint 
[J Script] public function get RemoteEndPoint() : EndPoint; 

Description 

Gets the remote endpoint. 

The System.Net.Sockets.SocketRemoteEndPoiiit property gets the 
network connection information associated with the remote network device. 
SocketType 
ToString 

[C#] pubhc SocketType SocketType {get;} 

[C++] public: property SocketType get_SocketType(); 

[VB] Public Readonly Property SocketType As SocketType 
[JScript] public function get SocketTypeQ : SocketType; 

Description 

Gets the type of the socket. 
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Accept 

[C#] public Socket AcceptQ; 

[C++] public: Socket* Accept(); 

[VB] Public Function AcceptQ As Socket 

[J Script] public function Accept() : Socket; 

Description 

Creates a new System.Net.Sockets.Socket to handle an incoming 
connection request. 

Return Value: A System.Net.Sockets.Socket instance to handle an incoming 
connection request. 

The System.Net.Sockets.SocketAccept method extracts the first 
connection request from the queue of pending requests and creates a new 
System.Net.Sockets.Socket instance to handle it. The 

System.Net.Sockets.Socket returned by System.Net.Sockets.Socket.Accept is a 
duplicate of the current System.Net.Sockets.Socket . 

Begin Accept 

[C#] public lAsyncResult BeginAccept(AsyncCallback callback, object state); 
[C++] public: lAsyncResult* BeginAccept(AsyncCallback=^ callback, Object* 
state); 

[VB] Public Function BeginAccept(ByVal callback As AsyncCallback, ByVal 
state As Object) As lAsyncResult 

[JScript] public function BeginAccept(callback : AsyncCallback, state : Object) : 
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lAsyncResult; 
Description 

Begins an asynchronous request to create a new socket to accept an 
incoming connection request. 

Return Value: An System.IAsyncResult that references the asynchronous socket 
creation. 
The 

System.Net.Sockets.Socket.BeginAccept(System.AsyncCallback,System.Objec 

t) method starts an asynchronous request to create a socket to handle an incoming 
connection request. The callback method that implements the 
System.AsyncCallback delegate uses the 

System.Net.Sockets.Socket.EiidAccept(SystemJAsyncResult) method to retum 
the socket. The System.AsyncCallbackdelegate. An object containing state 
information for this request. 
BeginConnect 

[C#] public lAsyncResult BeginConnect(EndPoint remoteEP, AsyncCallback 
callback, object state); 

[C++] public: lAsyncResult"^ BeginConnectCEndPoint"^ remoteEP, 
AsyncCallback* callback, Object* state); 

[VB] Public Function BeginConnect(ByVal remoteEP As EndPoint, ByVal 
callback As AsyncCallback, ByVal state As Object) As lAsyncResult 
[JScript] public function BeginConnect(remoteEP : EndPoint, callback : 
AsyncCallback, state : Object) : lAsyncResult; 
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Description 

Begins an asynchronous request for a connection to a network device. 
Return Value: An System.IAsyncResult that references the asynchronous 
connection. 

The 

System.Net.Sockets.Socket.BegiiiConnect(System.Net.EndPoint,System.Asyiic 
Callback,System.Object) method starts an asynchronous request for a connection 
to a remote device. The callback method that implements the 
System.AsyiicCallback delegate uses the 

System.Net.Sockets.Socket.EndConnect(System.IAsyncResult) method to 
return the socket. An System.Net.EndPointinstance that represents the remote 
device. The System. AsyncCallback delegate. An object that contains state 
information for this request. 
BeginReceive 

[C#] public lAsyncResult BeginReceive(byte[] buffer, int offset, int size, 
SocketFlags socketFlags, AsyncCallback callback, object state); 
[C++] public: lAsyncResult* BeginReceive(unsigned char buffer _gc[], int 
offset, int size, SocketFlags socketFlags, AsyncCallback* callback, Object* state); 
[VB] Public Function BeginReceive(ByVal bufferQ As Byte, ByVal offset As 
Integer, ByVal size As Integer, ByVal socketFlags As SocketFlags, ByVal 
callback As AsyncCallback, ByVal state As Object) As lAsyncResult 
[JScript] public function BeginReceive(buffer : Byte[], offset : int, size : int, 
socketFlags : SocketFlags, callback : AsyncCallback, state : Object) : 
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lAsyncResult; 
Description 

Begins to asynchronously receive data from a connected socket. 
Return Value: An SystemJAsyncResult that references the asynchronous read. 
The 

Systeni.NetSockets.Socket.BeginReceive(System.Byte[],System.Int32,System. 
Int32,System.NetSockets.SocketFlagS5System.AsyncCaIlback,System*Object) 

method starts asynchronously reading data from a socket. The callback method 
that implements the System.AsyncCallback delegate uses the 
System.Net.Sockets.Socket.EiidReceive(System.IAsyncResult) method to 
return the data read from the socket. The storage location for the received data. 
The zero-based position in the buffer at which to store the received data. The 
number of bytes to receive. A bitwise combination of the 
System.NetSockets.SocketFlags values. The System.AsyncCallback delegate. 
An object containing state information for this request. 
BeginReceiveFrom 

[C#] public lAsyncResult BeginReceiveFrom(byte[] buffer, int offset, int size, 
SocketFlags socketFlags, ref EndPoint remotcEP, AsyncCallback callback, object 
state); 

[C++] public: lAsyncResult* BeginReceiveFrom(unsigned char buffer gc[], int 

offset, int size, SocketFlags socketFlags, EndPoint** remoteEP, AsyncCallback* 
callback. Object* state); 

[VB] Public Function BeginReceiveFrom(ByVal buffer() As Byte, ByVal offset 
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As Integer, ByVal size As Integer, ByVal socketFlags As SocketFlags, ByRef 
remoteEP As EndPoint, ByVal callback As AsyncCallback, ByVal state As 
Object) As lAsyncResult 

[JScript] public function BeginReceiveFrom(buffer : Byte[], offset : int, size : int, 
socketFlags : SocketFlags, remoteEP : EndPoint, callback : AsyncCallback, state : 
Object) : lAsyncResult; 

Description 

Begins to asynchronously receive data from a specified network device. 
Return Value: An System.IAsyncResult that references the asynchronous read. 
The 

System.Net.Sockets.Socket.BeginReceiveFrom(System.Bytel],Systein.Iiit32,Sy 
stem.Int32,Systein.Net.Sockets.SocketFlags,System.Net.EndPoint@,System.A 
syncCaIlback,System.Object) method starts asynchronously reading data from a 
socket. The callback method that implements the System-AsyncCallback delegate 
uses the System.Net.Sockets.Socket.EndReceive(System.IAsyncResult) method 
to return the data read from the socket. The storage location for the received data. 
The zero-based position in the buffer at which to store the data. The number of 
bytes to receive. A bitwise combination of the System.Net.Sockets.SocketFIags 
values. An System.Net.EndPoint that represents the source of the data. The 
System.AsyncCallback delegate. An object containing state information for this 
request. 

BeginSend 

[C#] public lAsyncResult BeginSend(byte[] buffer, int offset, int size, SocketFlags 
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socketFlags, AsyncCallback callback, object state); 

[C++] public: lAsyncResult* BeginSend(uiisigned char buffer gc[], int offset, 

int size, SocketFlags socketFlags, AsyncCallback* callback, Object* state); 
[VB] Public Function BeginSend(ByVal buffer() As Byte, ByVal offset As 
Integer, ByVal size As Integer, ByVal socketFlags As SocketFlags, ByVal 
callback As AsyncCallback, ByVal state As Object) As lAsyncResult 
[JScript] public function BeginSend(buffer : Byte[], offset : int, size : int, 
socketFlags : SocketFlags, callback : AsyncCallback, state : Object) : 
lAsyncResult; 

Description 

Sends data asynchronously to a connected socket. 
Return Value: An System .lAsyncResult that references the asynchronous send. 
The 

System.Net.Sockets.Socket.BeginSend(System.Byte[],System.Int32,SystemJiit 
32,System.NetSockets.SocketFlags,System.AsyncCallback,System.Object) 

method starts asynchronously sending data through a socket. The callback method 
that implements the System.AsyncCallback delegate uses the 
System,Net.Sockets,SocketEndSend(SysteinJAsyncResult) method to 
complete sending data. The data to send. The zero-based position in bujfer at 
which to begin sending data. The number of bytes to send. A bitwise combination 
of the System.Net.Sockets.SocketFlags values. The System.AsyncCallback 
delegate. An object containing state information for this request. 
BeginSendTo 
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[C#] public lAsyncResult BeginSendTo(byte[] buffer, int offset, int size, 
SocketFlags socketFlags, EndPoint remoteEP, AsyncCallback callback, object 
state); 

[C++] public: lAsyncResult* BeginSendTo(unsigned char buffer gc[], int 

offset, int size, SocketFlags socketFlags, EndPoint* remoteEP, AsyncCallback* 
callback. Object* state); 

[VB] Public Function BeginSendTo(ByVal bufferQ As Byte, ByVal offset As 
Integer, ByVal size As Integer, ByVal socketFlags As SocketFlags, ByVal 
remoteEP As EndPoint, ByVal callback As AsyncCallback, ByVal state As 
Object) As lAsyncResult 

[JScript] public function BeginSendTo(buffer : Byte[], offset : int, size : int, 
socketFlags : SocketFlags, remoteEP : EndPoint, callback : AsyncCallback, state : 
Object) : LAsyncResult; 

Description 

Sends data asynchronously to a specific network device. 
Return Value: An SystemJAsyncResult that references the asynchronous send. 
The 

System.Net.Sockets.Socket.BeginSendTo(System.Byte[],System.Int32,System. 
Int32,System.Net.Sockets.SocketFlags,Systein.Net.EndPoint,System.AsyncCal 
Iback,System.Object) method starts asynchronously sending data through a 
socket. The callback method that implements the System.AsyncCaHback delegate 
uses the System.Net.Sockets.Socket.EndSendTo(System.IAsyncResult) method 
to complete sending data. The data to send. The zero-based position in buffer at 
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25 



which to begin sending data. The number of bytes to send. A bitwise combination 
of the System.Net.Sockets.SocketFlags values. An System.Net.EndPoint that 
represents the remote device. The System.AsyncCaIlback delegate. An object 
containing state information for this request. 
Bind 

[C#] public void Bind(EndPoint localEP); 
[C++] public: void Bind(EndPoint* localEP); 
[VB] Public Sub Bind(ByVal localEP As EndPoint) 
[JScript] pubhc function Bind(localEP : EndPoint); 

Description 

Associates a socket with a local endpoint. 
You must call the 

System.Net.Sockets.Socket.Bind(System.Net.EndPoint) method before you call 
the System.Net.Sockets.Socket.Listen(System.Int32) or 
System.Net.Sockets.Socket.Connect(System.Net.EndPoiiit) methods. The local 
System.Net.EndPoiiit to associate with the socket. 
Close 

[C#] public void Close(); 
[C++] public: void CloseQ; 
[VB] Pubhc Sub CloseQ 
[JScript] public function CloseQ; 
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Description 

Forces a socket connection to close. 

The System,Net.Sockets.SocketConnected property is set to false when 
the socket is closed. 
Connect 

[C#] public void Connect(EndPoint remoteEP); 
[C++] public: void Connect(EndPoint* remoteEP); 
[VB] Public Sub Connect(ByVal remoteEP As EndPoint) 
[JScript] public function Connect(remoteEP : EndPoint); 

Description 

Establishes a connection to a remote device. 

The System.Net.Sockets.Socket.Connect(System.Net.EndPomt) method 
establishes a network connection between 

System.Net.Sockets.SocketXocalEndPoint and the device identified by 
remoteEP . Once the connection has been made, you can send data to the remote 
device with the 

System.Net.Sockets.Socket.Send(System.Byte[],System.Int32,System.NetSock 

ets.SocketFlags) method, or receive data from the remote device with the 
System,NetSockets.Socket.Receive(System.Byte[],System.Int32,System,Net.S 
ockets-SocketFlags) method. An System.NetEndPoint instance that represents 
the remote device. 
Dispose 
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[C#] protected virtual void Dispose(bool disposing); 

[C++] protected: virtual void Dispose(bool disposing); 

[VB] Overridable Protected Sub Dispose(ByVal disposing As Boolean) 

[JScript] protected function Dispose(disposing : Boolean); 

Description 

EndAccept 

[C#] public Socket EndAccept(IAsyncResult asyncResult); 

[C++] public: Socket* EndAccept(IAsyncResult* asyncResult); 

[VB] Public Function EndAccept(ByVal asyncResult As lAsyncResult) As Socket 

[JScript] public function EndAccept(asyncResult : lAsyncResult) : Socket; 

Description 

Ends an asynchronous request to create a new socket to accept an incoming 
connection request. 

Return Value: A System.Net.Sockets,Socket to handle the incoming connection. 

The System.Net.Sockets.Socket.EndAccept(System.IAsyncResult) 
method completes a request for a connection that was started with the 
System.NetSockets.Socket.BeginAccept(System.AsyncCaUback,System.Objec 

t) method. The pending request for an incoming socket. 
EndConnect 
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[C#] public void EndConnect(IAsyncResult asyncResult); 
[C++] public: void EndCoiinect(IAsyncResult* asyncResult); 
[VB] Public Sub EndConnect(ByVal asyncResult As lAsyncResult) 
[JScript] public function EndConnect(asyncResult : I AsyncResult); 

Description 

Ends a pending synchronous connection request. The pending 
asynchronous connection request, 
EndReceive 

[C#] public int EndReceive(IAsyncResult asyncResult); 

[C++] public: int EndReceive(IAsyncResult'^ asyncResult); 

[VB] Public Function EndReceive(ByVal asyncResult As lAsyncResult) As 

Integer 

[JScript] public function EndReceive(asyncResult : lAsyncResult) : int; 

Description 

Ends a pending asynchronous read. 
Return Value: The number of bytes received. The pending asynchronous read. 

EndReceiveFrom 

[C#] public int EndReceiveFrom(IAsyncResult asyncResult, ref EndPoint 
endPoint); 

[C++] public: int EndReceiveFrom(I AsyncResult* asyncResult, EndPoint** 
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endPoint); 

[VB] Public Function EndReceiveFrom(ByVal asyncResult As lAsyncResult, 
ByRef endPoint As EndPoint) As Integer 

[JScript] public function EndReceiveFrom(asyncResult : lAsyncResult, endPoint : 
EndPoint) : int; 

Description 

Ends a pending asynchronous read from a specific endpoint. 
Return Value: If successful, the number of bytes received. If unsuccessful, then if 
the socket was closed with Systein.Net.Sockets.Socket.Close , returns 0; 
otherwise, returns an invalid socket error. The pending asynchronous read. The 
source endpoint. 

EndSend 

[C#] public int EndSend(I AsyncResult asyncResult); 
[C++] pubhc: int EndSend(IAsyncResult* asyncResult); 

[VB] Public Function EndSend(ByVal asyncResult As lAsyncResult) As Integer 
[JScript] public function EndSend(asyncResult : lAsyncResult) : int; 

Description 

Ends a pending asynchronous send. 
Return Value: If successful, the number of bytes sent to the socket; otherwise, an 
invalid socket error is returned. The pending asynchronous send. 

EndSendTo 
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[C#] public int EndSendTo(IAsyncResult asyncResult); 

[C++] public: int EndSendTo(I AsyncResult* asyncResult); 

[VB] Public Function EndSendTo(ByVal asyncResult As lAsyncResult) As 

Integer 

[JScript] public function EndSendTo(asyncResult : lAsyncResult) : int; 
Description 

Ends a pending asynchronous send to a specific location. 
Return Value: If successful, the number of bytes sent; otherwise, an invalid socket 
error is returned. The pending asynchronous send. 

Finalize 

[C#] -SocketO; 
[C++] -SocketO; 

[VB] Overrides Protected Sub FinalizeQ 
[JScript] protected override function FinalizeQ; 

Description 

Frees resources used by the System.Net.Sockets.Socket class. 

The System.Net.Sockets.Socket class finalizer calls the 
System.Net.Sockets.Socket.Close method to close the socket and fi-ee resources 
associated with the socket. 

GetHashCode 



Iee@hayes t^ic so9«324-9256 



2259 



M51'862USAPP 



[C#] public override int GetHashCodeQ; 
[C++] public: int GetHashCodeQ; 

[VB] Overrides Public Function GetHashCodeQ As Integer 
[JScript] public override function GetHashCodeQ : int; 

Description 

GetSocketOption 

[C#] public object GetSocketOption(SocketOptionLevel optionLevel, 
SocketOptionName optionName); 

[C++] public: Object* GetSocketOption(SocketOptionLevel optionLevel, 
SocketOptionName optionName); 

[VB] Public Function GetSocketOption(ByVal optionLevel As 
SocketOptionLevel, ByVal optionName As SocketOptionName) As Object 
[JScript] public function GetSocketOption(optionLevel : SocketOptionLevel, 
OptionName : SocketOptionName) : Object; Gets the value of a socket option. 

Description 

Gets the value of a specified socket option. 
Return Value: The value of the option. When optionName is set to 
System.Net.Sockets.SocketOptionName.Linger the return value is an instance 
of System.Net.Sockets.LingerOption . When optionName is set to 
Systeiii.Net.Sockets.SocketOptionName.AddMembershipor 
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System.Net.Sockets.SocketOptionName.DropMembership , the return value is 
an instance of System.Net.Sockets.MulticastOption . When optionName is any 
other value, the return value is an integer. One of the 
System.Net.Sockets.SocketOptionLevel values. One of the 
System.Net.Sockets.SocketOptionName values. 
GetSocketOption 

[C#] public void GetSocketOption(SocketOptionLevel optionLevel, 

SocketOptionName optionName, byte[] optionValue); 

[C++] pubHc: void GetSocketOption(SocketOptionLevel optionLevel, 

SocketOptionName optionName, unsigned char optionValue gc[]); 

[VB] Public Sub GetSocketOption(ByVal optionLevel As SocketOptionLevel, 
ByVal OptionName As SocketOptionName, ByVal optionValueQ As Byte) 
[JScript] public function GetSocketOption(optionLevel : SocketOptionLevel, 
optionName : SocketOptionName, optionValue : Byte[]); 

Description 

Gets the specified socket option setting. One of the 
System.Net.Sockets.SocketOptionLeveI values. One of the 
System.Net.Sockets.SocketOptionName values. The buffer to receive the option 
setting. 

GetSocketOption 

[C#] public byte[] GetSocketOption(SocketOptionLevel optionLevel, 
SocketOptionName optionName, int optionLength); 
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[C++] public: unsigned char GetSocketOption(SocketOptionLevel optionLevel, 

SocketOptionName optionName, int optionLength) ^gc[]; 

[VB] Public Function GetSocketOption(ByVal optionLevel As 
SocketOptionLevel, ByVal optionName As SocketOptionName, ByVal 
OptionLength As Integer) As ByteQ 

[JScript] public function GetSocketOption(optionLevel : SocketOptionLevel, 
OptionName : SocketOptionName, optionLength : int) : Byte[]; 

Description 

Gets the value of the specified socket option and returns an array. 
Return Value: An array of bytes containing the value of the socket option. 

The optionLength parameter sets the maximum size of the returned byte 
array. If the option value requires fewer bytes, the array will contain only that 
many bytes. If the option value requires more bytes, a 
System.Net.Sockets.SocketException will be thrown. One of the 
System.Net.Sockets.SocketOptionLevel values. One of the 
System.Net.Sockets.SocketOptionName values. The length, in bytes, of the 
expected return value. 

lOControl 

[C#] pubHc int IOControl(int ioControlCode, byte[] optionlnValue, byte[] 
optionOutValue) ; 

[C++] public: int IOControl(int ioControlCode, unsigned char optionlnValue 
gc[], unsigned char optionOutValue gc[]); 

[VB] Public Function IOControl(ByVal ioControlCode As Integer, ByVal 
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optionlnValueO As Byte, ByVal optionOutValue() As Byte) As Integer 
[JScript] public function IOControl(ioControlCode : int, optionlnValue : Byte[], 
optionOutValue : Byte[]) : int; 

Description 

Sets low-level operating modes for the socket. 
Return Value: The number of bytes returned in optionOutValue . 

The 

System.Net.Sockets.Socket.IOControl(System.Iiit32,System.Byte[],System.By 
te[]) method provides low-level access to the operating system socket underlying 
the System.Net.Sockets.Socket class instance. For more information about 
System.Net.Sockets.Socket.IOControI(System.Int32,System.Byte[],System.By 

tell) , see the documentation in MSDN. The control code of the operation to 
perform. The input data required by the operation. The output data returned by the 
operation. 

Listen 

[C#] public void Listen(int backlog); 

[C++] public: void Listen(int backlog); 

[VB] Public Sub Listen(ByVal backlog As Integer) 

[JScript] public function Listen(backlog : int); 

Description 

Places a socket in a listening state. 
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If System.Net.Sockets.Socket.Listen(System.Iiit32) is successful, 
System.Net.Sockets.Socket.Connected is set to true . Maximum length of the 
queue of pending connections. 

Poll 

[C#] public bool Poll(int microSeconds, SelectMode mode); 

[C++] public: bool Poll(int microSeconds, SelectMode mode); 

[VB] Public Function Poll(ByVal microSeconds As Integer, ByVal mode As 

SelectMode) As Boolean 

[JScript] public function Poll(microSeconds : int, mode : SelectMode) : Boolean; 

Description 

Determines the status of the socket. 
Return Value: Mode Return Value SelectRead ( System.Net.Sockets. SelectMode 
) true if System.Net.Sockets.Socket.Listen(System.Int32) has been called and a 
connection is pending, System.Net.Sockets.Socket.Accept will succeed -or- true 
if data is available for reading -or- true , if connection has been closed, reset, or 
terminated; otherwise, returns false . The time to wait for a response, in 
microseconds. One of the System.Net.Sockets.SelectMode values. 

Receive 

[C#] public int Receive(byte[] buffer); 

[C++] public: int Receive(unsigned char buffer gc[]); 

[VB] Public Function Receive(ByVal bufferQ As Byte) As Integer 
[JScript] public function Receive(buffer : Byte[]) : int; 
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Description 

Receives data from a connected socket into a specific location of the 
receive buffer. 

Return Value: The number of bytes received. Storage location for received data. 
Receive 

[C#] public int Receive(byte[] buffer, SocketFlags socketFlags); 
[C++] public: int Receive(unsigned char buffer _gc[], SocketFlags socketFlags); 
[VB] Public Function Receive(ByVal bufferQ As Byte, ByVal socketFlags As 
SocketFlags) As Integer 

[JScript] public function Receive(buffer : Byte[], socketFlags : SocketFlags) : int; 
Description 

Receives data from a connected socket into a specific location of the 
receive buffer. 

Return Value: The number of bytes received. Storage location for received data. A 
bitwise combination of the System.Net.Sockets.SocketFlags values. 
Receive 

[C#] public int Receive(byte[] buffer, int size, SocketFlags socketFlags); 

[C++] public: int Receive(unsigned char buffer gc[], int size, SocketFlags 

socketFlags); 

[VB] PubHc Function Receive(ByVal buffer() As Byte, ByVal size As Integer, 
ByVal socketFlags As SocketFlags) As Integer 
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[JScript] public function Receive(buffer : Byte[], size : int, socketFlags : 
SocketFlags) : int; Receives data from a connected socket. 

Description 

Receives data from a connected socket into a specific location of the 
receive buffer. 

Return Value: The number of bytes received. Storage location for received data, 
The number of bytes to receive. A bitwise combination of the 
System.Net.Sockets,SocketFlags values. 
Receive 

[C#] public int Receive(byte[] buffer, int offset, int size, SocketFlags socketFlags); 

[C++] public: int Receive(unsigned char buffer gc[], int offset, int size, 

SocketFlags socketFlags); 

[VB] Public Function Receive(ByVal buffer() As Byte, ByVal offset As Integer, 
ByVal size As Integer, ByVal socketFlags As SocketFlags) As Integer 
[JScript] public function Receive(buffer : Byte[], offset : int, size : int, socketFlags 
: SocketFlags) : int; 

Description 

Receives data from a connected socket into a specific location of the 
receive buffer. 

Return Value: The number of bytes received. Storage location for received data. 
The location in buffer to store the received data. The number of bytes to receive. A 
bitwise combination of the System.Net.Sockets.SocketFlags values. 
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ReceiveFrom 

[C#] public int ReceiveFrom(byte[] buffer, ref EndPoint remoteEP); 
[C++] public: int ReceiveFrom(unsigned char buffer _gc[], EndPoint** 
remoteEP); 

[VB] Public Function ReceiveFrom(ByVal buffer() As Byte, ByRef remoteEP As 
EndPoint) As Integer 

[JScript] public function ReceiveFrom(buffer : Byte[], remoteEP : EndPoint) : int; 
Description 

Receives a datagram into a specific location in the data buffer and stores the 
endpoint. 

Return Value: The number of bytes received. Storage location for received data. 
An System.Net.EndPoint, passed by reference, that represents the remote server. 
ReceiveFrom 

[C#] public int ReceiveFrom(byte[] buffer, SocketFlags socketFlags, ref EndPoint 
remoteEP); 

[C++] pubhc: int ReceiveFrom(unsigned char buffer gc[], SocketFlags 

socketFlags, EndPoint** remoteEP); 

[VB] Public Function ReceiveFrom(ByVal bufferQ As Byte, ByVal socketFlags 
As SocketFlags, ByRef remoteEP As EndPoint) As Integer 
[JScript] pubhc function ReceiveFrom(buffer : Byte[], socketFlags : SocketFlags, 
remoteEP : EndPoint) : int; 
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Description 

Receives a datagram into a specific location in the data buffer and stores the 
endpoint. 

Return Value: The number of bytes received. Storage location for received data. A 
bitwise combination of the System.Net.Sockets.SocketFlags values. An 
System.Net.EndPoint, passed by reference, that represents the remote server. 
ReceiveFrom 

10 [C#] pubHc int ReceiveFrom(byte[] buffer, int size, SocketFlags socketFlags, ref 

1 1 EndPoint remoteEP) ; 
[C++] public: int ReceiveFrom(unsigned char buffer _gc[], int size, SocketFlags 

13 SocketFlags, EndPoint** remoteEP); 

[VB] Public Function ReceiveFrom(ByVal buffer() As Byte, ByVal size As 
Integer, ByVal socketFlags As SocketFlags, ByRef remoteEP As EndPoint) As 
16 Integer 

[JScript] public function ReceiveFrom(buffer : Byte[], size : int, socketFlags : 
SocketFlags, remoteEP : EndPoint) : int; 
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Description 

Receives a datagram into a specific location in the data buffer and stores the 
endpoint. 

Return Value: The number of bytes received. Storage location for received data. 
The number of bytes to receive. A bitwise combination of the 
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System.Net.Sockets.SocketFlags values. An System.Net.EndPoint, passed by 
reference, that represents the remote server. 
ReceiveFrom 

[C#] public int ReceiveFrom(byte[] buffer, int offset, int size, SocketFlags 
socketFlags, ref EndPoint remoteEP); 

[C++] pubHc: int ReceiveFrom(unsigned char buffer _gc[], int offset, int size, 
SocketFlags socketFlags, EndPoint** remoteEP); 

[VB] Public Function ReceiveFrom(ByVal bufferQ As Byte, ByVal offset As 
Integer, ByVal size As Integer, ByVal socketFlags As SocketFlags, ByRef 
remoteEP As EndPoint) As Integer 

[JScript] public function ReceiveFrom(buffer : Byte[], offset : int, size : int, 
socketFlags : SocketFlags, remoteEP : EndPoint) : int; Receives a datagram and 
stores the source endpoint. 

Description 

Receives a datagram into a specific location in the data buffer and stores the 
endpoint. 

Return Value: The number of bytes received. Storage location for received data. 
The position in bujfer to store the received data. The number of bytes to receive. A 
bitwise combination of the System.Net.Sockets.SocketFlags values. An 
System.Net.EndPomt, passed by reference, that represents the remote server. 
Select 

[C#] public static void Select(IList checkRead, IList checkWrite, IList checkError, 
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int microseconds); 

[C++] public: static void Select(IList* checkRead, IList* checkWrite, IList* 
checkError, int microSeconds); 

[VB] Public Shared Sub Select(ByVal checkRead As IList, ByVal checkWrite As 
IList, ByVal checkError As IList, ByVal microSeconds As Integer) 
[JScript] public static function Select(checkRead : IList, checkWrite : IList, 
checkError : IList, microSeconds : int); 

Description 

Determines the status of a socket. 

System.Net.Sockets.Socket.SeIect(System.CoUections.IList,System.Coll 
ections.IList,System.Collections.IList,System.Int32) is a static method that 
determines the status of a set of System.Net.Sockets.Socket instances. For 
example, to determine which of a set of System.Net.Sockets.Socket instances has 
data ready to be read, place the System.Net.Sockets.Socket in an 
System.ColIections.IList instance, and then call 

System.Net.Sockets.Socket.Select(System.Collections.IList,System.Collections 

.IList,System.Collections.IList,System.Int32) After the call to 
System.Net.Sockets.Socket.Select(System.Coilections.IList,System.Collections 

.IList,System.CoIlections.IList,System.Int32) , the System.ColIections.IList 

will contain only those System.Net.Sockets.Socket instances with data ready to 
be read. A list of System.Net.Sockets.Socket instances to check for data to read. 
A list of System.Net.Sockets.Socket instances to check that are available for 
writing. A Hst of System.Net.Sockets.Socket instances to check for errors. The 
time to wait for a response, in microseconds. 
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Send 



[C#] public int Send(byte[] buffer); 

[C++] public: int Send(unsigned char buffer gc[]); 

[VB] Public Function Send(ByVal bufferQ As Byte) As Integer 
[JScript] public function Send(buffer : Byte[]) : int; 

Description 

Sends data to a connected socket, starting at the indicated location in the 

data. 

Return Value: The number of bytes sent to the socket. The data to be sent. 
Send 

[C#] public int Send(byte[] buffer, SocketFlags socketFlags); 
[C++] public: int Send(unsigned char buffer _gc[], SocketFlags socketFlags); 
[VB] Public Function Send(ByVal buffer() As Byte, ByVal socketFlags As 
SocketFlags) As Integer 

[JScript] public function Send(buffer : Byte[], socketFlags : SocketFlags) : int; 
Description 

Sends data to a connected socket, starting at the indicated location in the 

data. 

Return Value: The number of bytes sent to the socket. The data to be sent. A 
bitwise combination of the System.Net.Sockets.SocketFlags values. 
Send 
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[C#] public int Send(byte[] buffer, int size, SocketFlags socketFlags); 
[C++] public: int Send(unsigned char buffer _gc[], int size, SocketFlags 
socketFlags); 

[VB] Public Function Send(ByVal buffer() As Byte, ByVal size As Integer, ByVal 
socketFlags As SocketFlags) As Integer 

[JScript] public function Send(buffer : Byte[], size : int, socketFlags : 
SocketFlags) : int; Sends data to a connected socket. 

Description 

Sends data to a connected socket, starting at the indicated location in the 

data. 

Return Value: The number of bytes sent to the socket. The data to be sent. The 
number of bytes to send. A bitwise combination of the 
System.Net.Sockets.SocketFlags values. 
Send 

[C#] public int Send(byte[] buffer, int offset, int size, SocketFlags socketFlags); 

[C++] public: int Send(unsigned char buffer ^gc[], int offset, int size, 

SocketFlags socketFlags); 

[VB] Public Function Send(ByVal bufferQ As Byte, ByVal offset As Integer, 
ByVal size As Integer, ByVal socketFlags As SocketFlags) As Integer 
[JScript] public function Send(buffer : Byte[], offset : int, size : int, socketFlags : 
SocketFlags) : int; 
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Description 

Sends data to a connected socket, starting at the indicated location in the 

data. 

Return Value: The number of bytes sent to the socket. The data to be sent. The 
position in the data buffer to begin sending data. The number of bytes to send. A 
bitwise combination of the System.Net.Sockets.SocketFlags values. 
SendTo 

[C#] public int SendTo(byte[] buffer, EndPoint remoteEP); 
[C++] pubHc: int SendTo(unsigned char buffer __gc[], EndPoint* remoteEP); 
[VB] Public Function SendTo(ByVal bufferQ As Byte, ByVal remoteEP As 
EndPoint) As Integer 

[JScript] public function SendTo(buffer : Byte[], remoteEP : EndPoint) : int; 

Description 

Sends data to a specific endpoint. 
Return Value: The number of bytes sent. The data to be sent. The destination 
location for the data. 

SendTo 

[C#] public int SendTo(byte[] buffer, SocketFlags socketFlags, EndPoint 
remoteEP); 

[C++] public: int SendTo(unsigned char buffer _gc[], SocketFlags socketFlags, 
EndPoint* remoteEP); 
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[VB] Public Function SendTo(ByVal buffer() As Byte, ByVal socketFlags As 
SocketFlags, ByVal remoteEP As EndPoint) As Integer 
[JScript] public function SendTo(buffer : Byte[], socketFlags : SocketFlags, 
remoteEP : EndPoint) : int; 

Description 

Sends data to a specific endpoint. 
Return Value: The number of bytes sent. The data to be sent. A bitwise 
combination of the System.Net.Sockets.SocketFlags values. The destination 
location for the data. 

SendTo 

[C#] public int SendTo(byte[] buffer, int size, SocketFlags socketFlags, EndPoint 
remoteEP); 

[C++] public: int SendTo(unsigned char buffer gc[], int size, SocketFlags 

socketFlags, EndPoint* remoteEP); 

[VB] Public Function SendTo(ByVal bufferQ As Byte, ByVal size As Integer, 
ByVal socketFlags As SocketFlags, ByVal remoteEP As EndPoint) As Integer 
[JScript] public function SendTo(buffer : Byte[], size : int, socketFlags : 
SocketFlags, remoteEP : EndPoint) : int; 

Description 

Sends data to a specific endpoint. 
Return Value: The number of bytes sent. The data to be sent. The number of bytes 
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to send. A bitwise combination of the System.Net.Sockets.SocketFlags values. 
The destination location for the data. 
SendTo 

[C#] public int SendTo(byte[] buffer, int offset, int size, SocketFlags socketFlags, 
EndPoint remoteEP); 

[C++] public: int SendTo(unsigned char buffer _gc[], int offset, int size, 
SocketFlags socketFlags, EndPoint* remoteEP); 

[VB] PubUc Function SendTo(ByVal bufferQ As Byte, ByVal offset As Integer, 
ByVal size As Integer, ByVal socketFlags As SocketFlags, ByVal remoteEP As 
EndPoint) As Integer 

[JScript] public function SendTo(buffer : Byte[], offset : int, size : int, socketFlags 
: SocketFlags, remoteEP : EndPoint) : int; Sends data to a specific endpoint. 

Description 

Sends data to a specific endpoint, starting at the indicated location in the 

data. 

Return Value: The number of bytes sent. The data to be sent. The position in the 
data buffer to begin sending data. The number of bytes to send. A bitwise 
combination of the System.Net.Sockets.SocketFlags values. The destination 
location for the data. 

SetSocketOption 

[C#] public void SetSocketOption(SocketOptionLevel optionLevel, 
SocketOptionName optionName, byte[] optionValue); 
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[C++] public: void SetSocketOption(SocketOptionLevel optionLevel, 
SocketOptionName optionName, unsigned char optionValue _gc[]); 
[VB] Public Sub SetSocketOption(ByVal optionLevel As SocketOptionLevel, 
ByVal OptionName As SocketOptionName, ByVal optionValueQ As Byte) 
[JScript] public function SetSocketOption(optionLevel : SocketOptionLevel, 
OptionName : SocketOptionName, optionValue : Byte[]); 

Description 

Sets the specified option to the specified value. One of the 
System.Net.Sockets.SocketOptionLevel values. One of the 
System.Net.Sockets.SocketOptionName values. The value of the option. 

SetSocketOption 

[C#] public void SetSocketOption(SocketOptionLevel optionLevel, 
SocketOptionName optionName, int optionValue); 
[C++] public: void SetSocketOption(SocketOptionLevel optionLevel, 
SocketOptionName optionName, int optionValue); 

[VB] Public Sub SetSocketOption(ByVal optionLevel As SocketOptionLevel, 
ByVal OptionName As SocketOptionName, ByVal optionValue As Integer) 
[JScript] public function SetSocketOption(optionLevel : SocketOptionLevel, 
OptionName : SocketOptionName, optionValue : int); Sets a socket option. 

Description 
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Sets the specified option to the specified value. One of the 
System.Net.Sockets.SocketOptionLevel values. One of the 
Systein.Net.Sockets.SocketOptionName values. The value of the option. 

SetSocketOption 

[C#] public void SetSocketOption(SocketOptionLevel optionLevel, 

SocketOptionName optionName, object optionValue); 

[C++] public: void SetSocketOption(SocketOptionLevel optionLevel, 

SocketOptionName optionName, Object* optionValue); 

[VB] PubHc Sub SetSocketOption(ByVal optionLevel As SocketOptionLevel, 

ByVal optionName As SocketOptionName, ByVal optionValue As Object) 

[JScript] public function SetSocketOption(optionLevel : SocketOptionLevel, 

OptionName : SocketOptionName, optionValue : Object); 

Description 

Sets the specified option to the specified value. One of the 
System.Net.Sockets.SocketOptionLevel values. One of the 
System.Net.Sockets.SocketOptionName values. An instance of 
System.Net.Sockets.LingerOptionorSystem.Net.Sockets.MulticastOption 

containing the value of the option. 
Shutdown 

[C#] public void Shutdown(SocketShutdown how); 

[C++] public: void Shutdown(SocketShutdown how); 

[VB] Public Sub Shutdown(ByVal how As SocketShutdown) 
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[JScript] public function Shutdown(how : SocketShutdown); 

Description 

Disables sends and receives on a socket. 

The System.Net.Sockets.SocketShutdown class contains the vaUd values 
for how . The valid values are: Value Description Send Disable sending on this 
socket. The function that will no longer be allowed. 

IDisposable.Dispose 

[C#] void IDisposable.DisposeQ; 

[C++] void IDisposable::Dispose(); 

[VB] Sub DisposeO Implements IDisposable.Dispose 

[JScript] function IDisposable.DisposeQ; 

SocketException class (System.Net. Sockets) 
ToString 



Description 

The exception that is thrown when a socket error occurs. 

A System.Net.Sockets.SocketException is thrown by the 
System.Net.Sockets.Socket and System.Net.Dns classes when an error occurs 
with the network. 

SocketException 

Example Syntax: 

ToString 
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[C#] public SocketExceptionQ; 
[C++] public: SocketExceptionQ; 
[VB] Public Sub New() 

[JScript] public function SocketExceptionQ; Initializes a new instance of the 
System.NetSockets.SocketExceptioii class. 

Description 

Initializes a new instance of the System.Net.Sockets.SocketException 

class with the last operating system error code. 

The System.NetSockets.SocketExceptioii.#ctor constructor sets the 
System.Net,Sockets.SocketException*ErrorCode property to the last operating 
system socket error that occurred. For more information about socket error codes, 
see the Windows Socket Version 2 API error code documentation in MSDN. 

SocketException 

Example Syntax: 

ToString 

[C#] public SocketException(int errorCode); 
[C++] public: SocketException(int errorCode); 
[VB] Public Sub New(ByVal errorCode As Integer) 
[JScript] public function SocketException(errorCode : int); 

Description 
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Initializes a new instance of the System.Net.Sockets.SocketExceptioii 

class with the specified error code. 

The System.Net.Sockets.SocketExceptioii.#ctor constructor sets the 
System.Net.Sockets.SocketException.ErrorCode property to errorCode . The 
error code indicating the error that occurred. 

SocketException 

Example Syntax: 

ToString 

[C#] protected SocketException(SeriaUzationlnfo serializationlnfo, 
StreamingContext streamingContext); 

[C++] protected: SocketException(SerializationInfo* serializationlnfo, 
StreamingContext streamingContext); 

[VB] Protected Sub New(ByVal serializationlnfo As Serializationlnfo, ByVal 
StreamingContext As StreamingContext) 

[JScript] protected function SocketException(seriahzationInfo : Serializationlnfo, 
StreamingContext : StreamingContext); 

Description 

Initializes a new instance of the System.Net.Sockets.SocketExceptioii 
class from the specified instances of the 
System.Runtime.Serialization.SerializationInfo and 
System.Ruiitime.Serializatioii.StreainmgContext classes. 

This constructor implements the 
System.Ruiitime.Serialization.ISerializable interface for the 
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System.Net.Sockets.SocketException class. A 

System.Runtime.Serializatioii.SerializatioiiInfo instance containing the 
information required to serialize the new System-Net.Sockets.SocketExceptioii 
instance. A System.Runtime.Serialization.StreamingContext containing the 
source of the serialized stream associated with the new 
System.Net.Sockets.SocketExceptioii instance. 

ErrorCode 

ToString 

[C#] public override int ErrorCode {get;} 

[C++] public: property virtual int get_ErrorCode(); 

[VB] Overrides Public ReadOnly Property ErrorCode As Integer 

[JScript] public function get ErrorCodeQ : int; 

Description 

Gets the error code associated with this exception. 
The System.Net.Sockets.SocketException.ErrorCode property contains 
the error code associated with the error that caused the exception. 
HelpLink 
HResult 
InnerException 
Message 
NativeErrorCode 
Source 
StackTrace 
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TargetSite 

SocketFlags enumeration (System.Net.Sockets) 
ToString 

Description 

Provides constant values for socket messages. 
ToString 

[C#] public const SocketFlags DontRoute; 
[C++] public: const SocketFlags DontRoute; 
[VB] Public Const DontRoute As SocketFlags 
[JScript] public var DontRoute : SocketFlags; 

Description 

Send without using routing tables. 
ToString 

[C#] public const SocketFlags MaxIOVectorLength; 
[C++] public: const SocketFlags MaxIOVectorLength; 
[VB] Public Const MaxIOVectorLength As SocketFlags 
[JScript] public var MaxIOVectorLength : SocketFlags; 

Description 
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Provides a standard value for the number of WSABUF structures used to 
send and receive data. 
ToString 

[C#] public const SocketFlags None; 
[C++] public: const SocketFlags None; 
[VB] Public Const None As SocketFlags 
[JScript] public var None : SocketFlags; 

Description 

Use no flags for this call. 
ToString 

[C#] public const SocketFlags OutOfBand; 
[C++] public: const SocketFlags OutOfBand; 
[VB] Public Const OutOfBand As SocketFlags 
[JScript] public var OutOfBand : SocketFlags; 

Description 

Process out-of-band data. 
ToString 

[C#] public const SocketFlags Partial; 
[C++] public: const SocketFlags Partial; 
[VB] Public Const Partial As SocketFlags 
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[JScript] public var Partial : SocketFlags; 

Partial send or receive for message. 
ToString 

[C#] public const SocketFlags Peek; 
[C++] public: const SocketFlags Peek; 
[ VB] Public Const Peek As SocketFlags 
[JScript] public var Peek : SocketFlags; 

Description 

Peek at incoming message. 

SocketOptionLevel enumeration (System.Net. Sockets) 
ToString 



Description 

Defines socket option levels for the 
System.Net.Sockets.Socket.SetSocketOption(System.Net.Sockets.SocketOptio 

nLevel,System.Net.Sockets.SocketOptionName,SystemJnt32)and 
System.Net.Sockets.Socket.GetSocketOption(Systeni.Net.Sockets.SocketOptio 
nLevel,System.Net.Sockets.SocketOptionName) methods. 

The System.Net.Sockets,SocketOptionLeveI enumeration defines the 
socket option levels that can be passed to the 
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System.Net.Sockets.Socket.SetSocketOption(System.Net.Sockets.SocketOptio 
iiLevel,System.Net.Sockets.SocketOptionName,System.Int32)and 
System.Net.Sockets.Socket.GetSocketOption(System.Net.Sockets.SocketOptio 
nLevel,System.Net.Sockets.SocketOptionName) methods. 
ToString 

[C#] public const SocketOptionLevel IP; 
[C++] public: const SocketOptionLevel IP; 
[VB] Public Const IP As SocketOptionLevel 
[JScript] public var IP : SocketOptionLevel; 

Description 

Socket options apply to IP sockets. 
ToString 

[C#] public const SocketOptionLevel Socket; 
[C++] public: const SocketOptionLevel Socket; 
[VB] Public Const Socket As SocketOptionLevel 
[JScript] public var Socket : SocketOptionLevel; 

Description 

Socket options apply to the socket itself. 
ToString 

[C#] pubhc const SocketOptionLevel Tcp; 
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[C++] public: const SocketOptionLevel Tcp; 
[VB] Public Const Tcp As SocketOptionLevel 
[JScript] public var Tcp : SocketOptionLevel; 

Description 

Socket options apply to TCP sockets. 
ToString 

[C#] public const SocketOptionLevel Udp; 
[C++] public: const SocketOptionLevel Udp; 
[VB] Public Const Udp As SocketOptionLevel 
[JScript] public var Udp : SocketOptionLevel; 

Description 

Socket options apply to UDP sockets. 
SocketOptionName enumeration (System.Net.Sockets) 
ToString 



Description 

Defines socket option names for the System.Net.Sockets.Socket class. 
ToString 

[C#] public const SocketOptionName AcceptConnection; 
[C++] public: const SocketOptionName AcceptConnection; 
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[VB] Public Const AcceptConnection As SocketOptionName 
[JScript] public var AcceptConnection : SocketOptionName; 

Description 

Socket is listening. 
ToString 

[C#] public const SocketOptionName AddMembership; 
[C++] public: const SocketOptionName AddMembership; 
[VB] Public Const AddMembership As SocketOptionName 
[JScript] public var AddMembership : SocketOptionName; 

Description 

Add an IP group membership. 
ToString 

[C#] public const SocketOptionName AddSourceMembership; 
[C++] pubHc: const SocketOptionName AddSourceMembership; 
[VB] Public Const AddSourceMembership As SocketOptionName 
[JScript] public var AddSourceMembership : SocketOptionName; 

Description 

Join a source group. 
ToString 
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[C#] public const SocketOptionName BlockSource; 
[C++] public: const SocketOptionName BlockSource; 
[ VB] Public Const BlockSource As SocketOptionName 
[ JScript] public var BlockSource : SocketOptionName; 

Description 

Block data from a source. 
ToString 

[C#] public const SocketOptionName Broadcast; 
[C++] public: const SocketOptionName Broadcast; 
[ VB] Public Const Broadcast As SocketOptionName 
[JScript] public var Broadcast : SocketOptionName; 

Description 

Permit sending broadcast messages on the socket. 
ToString 

[C#] public const SocketOptionName BsdUrgent; 
[C++] public: const SocketOptionName BsdUrgent; 
[VB] Public Const BsdUrgent As SocketOptionName 
[JScript] public var BsdUrgent : SocketOptionName; 

Description 
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Use urgent data as defined in RFC-1222. This option can be set only once, 
and once set, cannot be turned off. 
ToString 

[C#] public const SocketOptionName ChecksumCoverage; 
[C++] public: const SocketOptionName ChecksumCoverage; 
[VB] Public Const ChecksumCoverage As SocketOptionName 
[JScript] public var ChecksumCoverage : SocketOptionName; 

10 Description 

n Set or get UDP checksum coverage. 

12 ToString 

13 
14 



15 



[C#] public const SocketOptionName Debug; 
[C++] public: const SocketOptionName Debug; 

16 [VB] Public Const Debug As SocketOptionName 

17 [JScript] public var Debug : SocketOptionName; 
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Description 

Record debugging information. 
ToString 

[C#] public const SocketOptionName DontFragment; 
[C++] public: const SocketOptionName DontFragment; 
[VB] Public Const DontFragment As SocketOptionName 
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[ JScript] public var DontFragment : SocketOptionName; 



Description 

Do not fragment IP datagrams. 
ToString 

[C#] public const SocketOptionName DontLinger; 
[C++] public: const SocketOptionName DontLinger; 
[VB] Public Const DontLinger As SocketOptionName 
[JScript] public var DontLinger : SocketOptionName; 

Description 

Close socket gracefully without lingering. 
ToString 

[C#] public const SocketOptionName DontRoute; 
[C++] public: const SocketOptionName DontRoute; 
[VB] Public Const DontRoute As SocketOptionName 
[JScript] public var DontRoute : SocketOptionName; 

Description 

Do not route; send directly to interface addresses. 
ToString 

[C#] public const SocketOptionName DropMembership; 
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[C++] public: const SocketOptionName DropMembership; 
[VB] Public Const DropMembership As SocketOptionName 
[JScript] public var DropMembership : SocketOptionName; 

Description 

Drop an IP group membership. 
ToString 

[C#] pubUc const SocketOptionName DropSourceMembership; 
[C++] public: const SocketOptionName DropSourceMembership; 
[VB] Public Const DropSourceMembership As SocketOptionName 
[JScript] pubHc var DropSourceMembership : SocketOptionName; 

Description 

Drop a source group. 
ToString 

[C#] public const SocketOptionName Error; 
[C++] public: const SocketOptionName Error; 
[VB] Public Const Error As SocketOptionName 
[JScript] public var Error : SocketOptionName; 

Description 

Get error status and clear. 
ToString 



lee@hayes piic s09.324.9256 



2291 



[C#] public const SocketOptionName ExclusiveAddressUse; 
[C++] public: const SocketOptionName ExclusiveAddressUse; 
[VB] Public Const ExclusiveAddressUse As SocketOptionName 
[JScript] public var ExclusiveAddressUse : SocketOptionName; 

Description 

Enables a socket to be bound for exclusive access. 
ToString 

[C#] public const SocketOptionName Expedited; 
[C++] public: const SocketOptionName Expedited; 
[VB] Public Const Expedited As SocketOptionName 
[JScript] public var Expedited : SocketOptionName; 

Description 

Use expedited data as defined in RFC- 1222. This option can be set only 
once, and once set, cannot be turned off. 
ToString 

[C#] public const SocketOptionName Headerlncluded; 
[C++] public: const SocketOptionName Headerlncluded; 
[VB] Public Const Headerlncluded As SocketOptionName 
[JScript] public var Headerlncluded : SocketOptionName; 
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Description 

Indicates application is providing the IP header for outgoing datagrams. 
ToString 

[C#] public const SocketOptionName IPOptions; 
[C++] public: const SocketOptionName IPOptions; 
[VB] Public Const IPOptions As SocketOptionName 
[JScript] public var IPOptions : SocketOptionName; 

Description 

Specifies IP options to be inserted into outgoing datagrams. 
ToString 

[C#] public const SocketOptionName IpTimeToLive; 
[C++] public: const SocketOptionName IpTimeToLive; 
[VB] Public Const IpTimeToLive As SocketOptionName 
[JScript] public var IpTimeToLive : SocketOptionName; 

Description 

Set the IP header time-to-live field. 
ToString 

[C#] public const SocketOptionName KeepAlive; 
[C++] public: const SocketOptionName KeepAlive; 
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[VB] Public Const KeepAlive As SocketOptionName 
[JScript] public var KeepAlive : SocketOptionName; 

Description 

Send keep-alives. 
ToString 

[C#] public const SocketOptionName Linger; 
[C++] public: const SocketOptionName Linger; 
[VB] Public Const Linger As SocketOptionName 
[JScript] public var Linger : SocketOptionName; 

Description 

Linger on close if unsent data is present. 
ToString 

[C#] public const SocketOptionName MaxConnections; 
[C++] public: const SocketOptionName MaxConnections; 
[VB] Public Const MaxConnections As SocketOptionName 
[JScript] public var MaxConnections : SocketOptionName; 

Description 

Maximum queue length that can be specified by 
Systein.Net.Sockets.Socket.Listen(System.Int32) 

ToString 
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[C#] public const SocketOptionName Multicastlnterface; 
[C++] public: const SocketOptionName Multicastlnterface; 
[ VB] Public Const Multicastlnterface As SocketOptionName 
[JScript] public var Multicastlnterface : SocketOptionName; 

Description 

Set the interface for outgoing multicast packets. 
ToString 

[C#] public const SocketOptionName MulticastLoopback; 
[C++] public: const SocketOptionName MulticastLoopback; 
[VB] Public Const MulticastLoopback As SocketOptionName 
[JScript] public var MulticastLoopback : SocketOptionName; 

Description 

IP multicast loopback. 
ToString 

[C#] public const SocketOptionName MulticastTimeToLive; 
[C++] public: const SocketOptionName MulticastTimeToLive; 
[VB] Public Const MulticastTimeToLive As SocketOptionName 
[JScript] public var MulticastTimeToLive : SocketOptionName; 

Description 
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IP multicast time to live. 
ToString 

[C#] public const SocketOptionName NoChecksum; 
[C++] public: const SocketOptionName NoChecksum; 
[VB] Public Const NoChecksum As SocketOptionName 
[JScript] pubHc var NoChecksum : SocketOptionName; 

Description 

Send UDP datagrams with checksum set to zero. 
ToString 

[C#] public const SocketOptionName NoDelay; 
[C++] public: const SocketOptionName NoDelay; 
[VB] Public Const NoDelay As SocketOptionName 
[JScript] public var NoDelay : SocketOptionName; 

Description 

Disables the Nagle algorithm for send coalescing. 
ToString 

[C#] public const SocketOptionName OutOfBandlnline; 
[C++] public: const SocketOptionName OutOfBandlnline; 
[VB] Public Const OutOfBandlnline As SocketOptionName 
[JScript] public var OutOfBandlnline : SocketOptionName; 
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Description 

Receives out-of-band data in the normal data stream. 
ToString 

[C#] public const SocketOptionName Packetlnformation; 
[C++] public: const SocketOptionName Packetlnformation; 
[VB] Public Const Packetlnformation As SocketOptionName 
[JScript] public var Packetlnformation : SocketOptionName; 

Description 

Retum information about received packets. 
ToString 

[C#] public const SocketOptionName ReceiveBuffer; 
[C++] public: const SocketOptionName ReceiveBuffer; 
[VB] Public Const ReceiveBuffer As SocketOptionName 
[JScript] public var ReceiveBuffer : SocketOptionName; 

Description 

Send low water mark. 
ToString 

[C#] public const SocketOptionName ReceiveLowWater; 
[C++] public: const SocketOptionName ReceiveLowWater; 



lee@hayes piic 509-324.9256 



2297 



MS1-86ZU5APP 



1 

2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 



[VB] Public Const ReceiveLowWater As SocketOptionName 
[ JScript] public var ReceiveLowWater : SocketOptionName; 

Description 

Receive low water mark. 
ToString 

[C#] public const SocketOptionName ReceiveTimeout; 
[C+-H] public: const SocketOptionName ReceiveTimeout; 
[VB] Public Const ReceiveTimeout As SocketOptionName 
[JScript] public var ReceiveTimeout : SocketOptionName; 

Description 

Receive time out. 
ToString 

[C#] public const SocketOptionName ReuseAddress; 
[C++] public: const SocketOptionName ReuseAddress; 
[ VB] Public Const ReuseAddress As SocketOptionName 
[JScript] public var ReuseAddress : SocketOptionName; 

Description 

Allows the socket to be bound to an address that is already in use. 
ToString 
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[C#] public const SocketOptionName SendBuffer; 
[C++] public: const SocketOptionName SendBuffer; 
[VB] Public Const SendBuffer As SocketOptionName 
[JScript] public var SendBuffer : SocketOptionName; 

Description 

Specifies the total per-socket buffer space reserved for sends. This is 
unrelated to the maximum message size or the size of a TCP window. 
ToString 

[C#] public const SocketOptionName SendLowWater; 
[C++] public: const SocketOptionName SendLowWater; 
[VB] PubUc Const SendLowWater As SocketOptionName 
[JScript] public var SendLowWater : SocketOptionName; 

Description 

Specifies the total per-socket buffer space reserved for receives. This is 
unrelated to the maximum message size or the size of a TCP window. 
ToString 

[C#] pubUc const SocketOptionName SendTimeout; 
[C++] public: const SocketOptionName SendTimeout; 
[VB] PubHc Const SendTimeout As SocketOptionName 
[JScript] public var SendTimeout : SocketOptionName; 
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Description 

Send timeout. 
ToString 

[C#] public const SocketOptionName Type; 
[C++] public: const SocketOptionName Type; 
[VB] Public Const Type As SocketOptionName 
[ JScript] public var Type : SocketOptionName; 

Description 

Get socket type. 
ToString 

[C#] public const SocketOptionName TypeOfService; 
[C++] public: const SocketOptionName TypeOfService; 
[VB] Public Const TypeOfService As SocketOptionName 
[JScript] public var TypeOfService : SocketOptionName; 

Description 

Change the IP header type of service field. 
ToString 

[C#] public const SocketOptionName UnblockSource; 
[C++] public: const SocketOptionName UnblockSource; 
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[VB] Public Const UnblockSource As SocketOptionName 
[JScript] public var UnblockSource : SocketOptionName; 

Description 

Unblock a previously blocked source. 
ToString 

[C#] public const SocketOptionName UseLoopback; 
[C++] public: const SocketOptionName UseLoopback; 
[VB] Public Const UseLoopback As SocketOptionName 
[JScript] public var UseLoopback : SocketOptionName; 

Description 

Bypass hardware when possible. 

SocketShutdown enumeration (System.Net.Sockets) 

ToString 



Description 

Defines constants used by the 
System.Net.Sockets-Socket.Shutdown(System.Net.Sockets.SocketShutdown) 

method. 

The System.Net»Sockets,SocketShutdown class is a helper class that 
defines the values that can be passed to the 
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System*Net.Sockets.Socket.Shutdowii(System.NetSockets.SocketShutdown) 

method. 

ToString 

[C#] public const SocketShutdown Both; 
[C++] pubhc: const SocketShutdown Both; 
[VB] Public Const Both As SocketShutdown 
[JScript] public var Both : SocketShutdown; 

Description 

Shuts down a socket for both sending and receiving. This field is constant. 
ToString 

[C#] public const SocketShutdown Receive; 
[C++] public: const SocketShutdown Receive; 
[VB] Public Const Receive As SocketShutdown 
[JScript] public var Receive : SocketShutdown; 

Description 

Shuts down a socket for receiving. This field is constant. 
ToString 

[C#] public const SocketShutdown Send; 
[C++] pubKc: const SocketShutdown Send; 
[VB] Pubhc Const Send As SocketShutdown 
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[JScript] public var Send : SocketShutdown; 



Description 

Shuts down a socket for sending. This field is constant. 
SocketType enumeration (System.Net.Sockets) 
ToString 

Description 

Specifies the type of socket an instance of the System.Net.Sockets*Socket 

class represents. 
ToString 

[C#] public const SocketType Dgram; 
[C++] public: const SocketType Dgram; 
[VB] Public Const Dgram As SocketType 
[JScript] public var Dgram : SocketType; 

Description 

ToString 

[C#] public const SocketType Raw; 
[C++] pubhc: const SocketType Raw; 
[VB] Public Const Raw As SocketType 
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[JScript] public var Raw : SocketType; 
Description 

ToString 

[C#] public const SocketType Rdm; 
[C++] public: const SocketType Rdm; 
[VB] Public Const Rdm As SocketType 
[JScript] public var Rdm : SocketType; 

Description 

ToString 

[C#] public const SocketType Seqpacket; 
[C++] public: const SocketType Seqpacket; 
[VB] Public Const Seqpacket As SocketType 
[JScript] public var Seqpacket : SocketType; 

Description 

ToString 

[C#] public const SocketType Stream; 



lee@hayes ptic 509*324.9255 



2304 



[C++] public: const SocketType Stream; 
[VB] Public Const Stream As SocketType 
[JScript] public var Stream : SocketType; 

Description 

ToString 

[C#] public const SocketType Unknown; 
[C++] public: const SocketType Unknown; 
[VB] Public Const Unknown As SocketType 
[JScript] public var Unknown : SocketType; 

Description 

TcpClient class (System.Net.Sockets) 
ToString 



Description 

Provides client connections for TCP network services. 

The System.Net.Sockets.TcpClient class builds upon the 
System.Net.Sockets.Socket class to provide TCP services at a higher level of 
abstraction. You can establish a System.Net.Sockets.TcpClieiit connection can be 
establish by one of two ways. 
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TcpClient 
2 II Example Syntax: 

3 11 ToString 

[C#] public TcpClientQ; 
6 II [C++] public: TcpClientQ; 
[VB] Public Sub New() 
[JScript] public function TcpClient(); 

9| 

10 1 1 Description 

Initializes a new instance of the System.NetSockets.TcpClient class. 
The default constructor sets the IP address to System.Net.IPAddress.Any 

13 II and the port number to 0. 

14 TcpClient 

15 Example Syntax: 

16 I ToString 

17 

18 11 [C#] public TcpClient(IPEndPoint localEP); 

19 II [C++] public: TcpClient(IPEndPoint* localEP); 

20 II [VB] Public Sub New(ByVal localEP As IPEndPoint) 

21 II [JScript] pubHc function TcpClient(localEP : IPEndPoint); Initializes a new 

22 ij instance of the Systein.Net.Sockets.TcpClient class. 

23 

24 I Description 

25 
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Initializes a new instance of the System.Net.Sockets.TcpClient class with 

the local endpoint. 

The localEP parameter specifies the local endpoint. This constructor 
instantiates a socket and binds that socket to the provided local endpoint. The local 
endpoint to which you bind the TCP connection. 

TcpCUent 

Example Syntax: 

ToString 

[C#] public TcpClient(string hostname, int port); 

[C++] pubhc: TcpClient(String* hostname, int port); 

[VB] Public Sub New(ByVal hostname As String, ByVal port As Integer) 

[JScript] public function TcpClient(hostname : String, port : int); 

Description 

Initializes anew instance of the System.Net.Sockets.TcpClient class and 
connects to the specified port on the specified host. 

This constructor accepts two parameters. Name of the remote host to which 
you intend to connect. Port number of the remote host to which you intend to 
connect. 

Active 

ToString 

[C#] protected bool Active {get; set;} 

[C++] protected: property bool get_Active();protected: __property void 
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set_Active(bool); 

[VB] Protected Property Active As Boolean 

[JScript] protected function get ActiveQ : Boolean;protected function set 
Active(Boolean); 

Description 

Gets or set a value that indicates whether a connection has been made. 

Client 

ToString 

[C#] protected Socket CUent {get; set;} 

[C++] protected: _property Socket* get_ClientO;protected: _property void 
set_Client(Socket*); 

[VB] Protected Property Client As Socket 

[JScript] protected function get ClientQ : Socket;protected function set 
Client(Socket); 

Description 

Gets or sets the underlying System.Net.Sockets.Socket instance. 
Use this property to set or get the underlying System.Net.Sockets.Socket 
instance of System.Net.Sockets.TcpClient . 

LingerState 
ToString 

[C#] public LingerOption LingerState {get; set;} 
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[C++] public: property LingerOption* get_LingerState();public: property 

void set_LingerState(LingerOption*); 

[VB] Public Property LingerState As LingerOption 

[JScript] public function get LingerState() : LingerOption;public function set 
LingerState(LingerOption); 

Description 

Gets or sets the value of the connection's 
System.Net.Sockets.LmgerOption An instance of the 
System.NetSockets.LmgerOption class. 

This property sets or gets a System.Net.Sockets.LingerOption instance. If 
the System*Net,Sockets.LmgerOption,Enabled property of the 
System.Net,Sockets.LingerOption instance is true, and data remains to be sent, 
then System^NetSockets.TcpClient remains open even after 
System.Net.Sockets.TcpClient.Close is called. The amount of time the object 
remains open is specified by the System^NetSockets.LingerOption.LingerTime 
property of the System.Net.Sockets.LmgerOption instance. If the Enabled 
property of the System.NetSockets.LingerOption instance is false, then 
System.Net.Sockets«TCPClient will close immediately, even if data remains to 
be sent. 

NoDelay 

ToString 

[C#] pubhc bool NoDelay {get; set;} 

[C++] public: property bool get_NoDelay();public: property void 



lee@hayes piic 509.324-9256 



2309 



MS1-862US.APP 



1 

2 
3 
4 
5 
6 
7 
8 
9 

10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 



set_NoDelay(bool) ; 

[VB] Public Property NoDelay As Boolean 

[JScript] public function get NoDelayQ : Boolean;public function set 
NoDelay(Boolean); 

Description 

Gets or sets a value that enables a delay when send or receive buffers are 

full. 

If System.Net.Sockets.TcpCIient.NoDelay is set to false , 
System.Net.Sockets.TcpClient delays the sending and receiving of data while 
buffers are full. If System.Net.Sockets*TcpClient.NoDelay is set to true , then 
System.Net^Sockets.TcpClient continues writing to buffers even if there is no 
capacity left. 

ReceiveBufferSize 

ToString 

[C#] public int ReceiveBufferSize {get; set;} 

[CH-+] public: property int get_ReceiveBufferSize();public: property void 

set_ReceiveBufferSize(int); 

[VB] Public Property ReceiveBufferSize As Integer 

[JScript] public function get ReceiveBufferSizeQ : int;public function set 

ReceiveBufferSize(int) ; 

Description 

Gets or sets the size of the receive buffer. 
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The System.Net.Sockets.TcpClieiit.ReceiveBufferSize property gets or 
sets the amount of bytes that can be stored in the receive buffer. After using 
System.Net.Sockets-TcpClient.GetStream to retrieve the underlying 
System.Net,Sockets.NetworkStream instance, you will initiate a read by using 
one of the System.Net.Sockets.NetworkStream read methods. The amount of 
data that can be stored from this read, will be determined by the 
System.Net-Sockets.TcpClieiit.ReceiveBufferSize property. 

ReceiveTimeout 
ToString 

[C#] public int ReceiveTimeout {get; set;} 

[C++] public: ^property int get_ReceiveTimeout();public: property void 
set_ReceiveTimeout(int) ; 

[VB] Public Property ReceiveTimeout As Integer 

[JScript] public function get ReceiveTimeoutQ : int;public function set 

ReceiveTimeout(int) ; 

Description 

Gets or sets the amount of time a System.Net.Sockets.TcpClieiit object 
will wait to receive data once a read is initiated. 

The System.Net*Sockets.TcpClieiit.ReceiveTimeout property determines 
the amount of time a System.Net.Sockets.TcpClient object will wait to receive 
data after a read is initiated. This time is measured in milliseconds. 

SendBufferSize 

ToString 
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[C#] public int SendBufferSize {get; set;} 

[CH-+] public: property int get_SendBufferSize();public: property void 

set_SendBufferSize(int); 

[VB] Public Property SendBufferSize As Integer 

[JScript] public function get SendBufferSizeQ : int;public function set 

SendBufferSize(int); 

Description 

Gets or sets the size of the send buffer. 

The System.Net.Sockets.TcpClient.SendBufferSize property gets or sets 
the amount of bytes that can be stored in the send buffer. After using 
System.Net.Sockets.TcpClient*GetStream to retrieve the underlying 
System.Net.Sockets.NetworkStream instance, you will initiate a send by using 
one of the System.Net.Sockets*NetworkStream send methods. The amount of 
data that can be sent for each send, will be determined by the 
System.Net.Sockets.TcpClient.SendBufferSize property. 

SendTimeout 

ToString 

[C#] public int SendTimeout {get; set;} 

[C++] public: property int get SendTimeout();public: property void 

setSendTimeout(int); 

[VB] Public Property SendTimeout As Integer 

[JScript] public function get SendTimeout() : int;public function set 
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SendTimeout(int); 
Description 

Gets or sets the amount of time a System.NetSockets.TcpClient object 
will wait to receive confirmation you initiate a send. 

After you initiate a send, the underlying System.Net.Sockets.Socket 
instance retums the number of bytes actually sent to the host. The 
System^Net.Sockets.TcpClientSendTimeout property determines the amount of 
time a System.Net,Sockets.TcpClieiit object will wait before receiving the 
number of bytes retumed by the System.NetSockets.Socket class. 

Close 

[C#] public void CloseQ; 
[C++] pubHc: void CloseQ; 
[VB] Public Sub CloseQ 
[JScript] public function CloseQ; 

Description 

Closes the TCP connection. 
Closes the TCP connection. 
Connect 

[C#] public void Connect(IPEndPoint remoteEP); 
[C++] pubhc: void Connect(IPEndPoint* remoteEP); 
[VB] Public Sub Connect(ByVal remoteEP As IPEndPoint) 
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[JScript] public function Connect(remoteEP : IPEndPoint); 



Description 

Connects the client to a remote TCP host using the specified remote 
network endpoint. 

System.Net.Sockets.TcpCIient.Connect(System.String,System.Int32) 

establishes a TCP connection using the specified network endpoint. Before you 
call System.Net.Sockets.TcpClieiit.Connect(System.String,System.Iiit32) , you 
must first instantiate an System.Net.IPEndPoint object using an IP address and 
port number. This is your network end-point. After you have instantiated the 
System.Net.Sockets.IPEndPoint object, you can then call 
System.Net.Sockets.TcpClient.Connect(System.String,System.Int32)and use 

the System.Net.IPEndPoint object as its argument. The IP endpoint to which you 
intend to connect. 
Connect 

[C#] public void Comiect(IP Address address, int port); 

[C++] public: void Connect(IP Address* address, int port); 

[VB] Public Sub Connect(ByVal address As IP Address, ByVal port As Integer) 

[JScript] public function Connect(address : IP Address, port : int); 

Description 

Connects the client to a remote TCP host using the specified IP Address 
and port number. 
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System.Net,Sockets^TcpClientConnect(System,Strmg,SystemJiit32) 

establishes a TCP connection using the specified port and IP address. This method 
estabUshes a connection by calling the 

Systeni.Net.Sockets.Socket.Connect(System.NetEndPomt) method of the 
underlying System.Net.Sockets.Socket instance. After the connection is 
established, you can use the underlying System.Net.Sockets.NetworkStream 
instance to send and receive data. Use System.Net.Sockets.TcpClient.GetStream 
to obtain the underlying System.Net.Sockets-NetworkStreain instance. IP 
address of the host to which you intend to connect. The port number to which you 
intend to connect. 
Connect 

[C#] public void CoTmect(string hostname, int port); 

[C++] public: void Connect(String* hostname, int port); 

[VB] Public Sub Connect(ByVal hostname As String, ByVal port As Integer) 

[JScript] public function Connect(hostname : String, port : int); Connects the client 

to a remote TCP host using the specified host name and port number. 

Description 

Connects the client to the specified port on the specified host. 

System,Net.Sockets.TcpClientConnect(System.String,System.Int32) 
establishes a TCP connection to the host device using the specified port and 
hostname specified. This method establishes a connection by calling the 
System,Net.Sockets.Socket.Connect(System.NetEndPomt) method of the 
underlying System^Net.Sockets.Socket instance. After the connection is 
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established, you can use the underlying System,Net.Sockets,NetworkStream 
instance to send and receive data. Use System.Net.Sockets,TcpClient.GetStream 
to obtain the underlying System,Net.Sockets,NetworkStream instance. Name of 
the remote host to which you intend to connect. Port number of the remote host to 
which you intend to connect. 
Dispose 

[C#] protected virtual void Dispose(bool disposing); 

[C++] protected: virtual void Dispose(bool disposing); 

[VB] Overridable Protected Sub Dispose(ByVal disposing As Boolean) 

[JScript] protected function Dispose(disposing : Boolean); 

Description 

Releases the unmanaged resources used by the 
System-Net.Sockets.TcpClient and optionally releases the managed resources. 

This method releases the underlying System.Net^Sockets.NetworkStream 
and System,Net.Sockets.Socket instances. There are no managed resources that 
require releasing. If you call 

Systeiii.Net.Sockets.TcpClientDispose(System.Boolean) and specify true as its 
parameter, then be sure to suppress the finalizer by calling the 
System.Net.Sockets.TcpClieiit.suppressfinalize method of the garbage collector. 
If true, releases both managed and unmanaged resources; if false, releases only 
unmanaged resources. 
Finalize 
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[C#] -TcpClientO; 

[C++] -TcpClientO; 

[VB] Overrides Protected Sub FinalizeQ 

[JScript] protected override function FinalizeQ; 

Description 

Frees resources used by the System.Net.Sockets.TcpClient class. 

The System.Net.Sockets.TcpClient class fmalizer calls the 
System.Net.Sockets.TcpCIieiit.Close method to close the TCP connection, shut 
down the network stream, and free the socket. 

GetStream 

[C#] public NetworkStream GetStreamQ; 

[C++] public: NetworkStream* GetStream(); 

[VB] Public Function GetStream() As NetworkStream 

[JScript] public function GetStream() : NetworkStream; 

Description 

Returns the stream used to send and receive data. 
Return Value: The underiying System.Net.Sockets.NetworkStream instance. 

System.Net.Sockets.TcpClient.GetStream returns the underlying 
System.Net.Sockets.NetworkStream used to send and receive data. 

IDisposable.Dispose 
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[C#] void IDisposable.DisposeQ; 

[C++] void IDisposable::Dispose(); 

[VB] Sub DisposeQ Implements IDisposable.Dispose 

[JScript] function IDisposable.DisposeQ; 

TcpListener class (System.Net. Sockets) 

ToString 

Description 

Listens for connections from TCP network clients. 

The System.Net.Sockets.TcpListener class builds upon the 
System.Net.Sockets.Socket class to provide TCP services at a higher level of 
abstraction. 

TcpListener 

Example Syntax: 

ToString 

[C#] public TcpListener(int port); 

[C++] public; TcpListener(int port); 

[ VB] Pubhc Sub New(ByVal port As Integer) 

[JScript] public function TcpListener(port : int); 

Description 
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Initializes a new instance of the System.Net.Sockets.TcpListener that 
Ustens on the specified port. 

The port parameter specifies the local port number on which you intend to 
listen. This constructor instantiates the underlying 

System.Net.Sockets.IPEndPoint using the specified port number. When you call 
System.Net.Sockets-TcpListener.Start , System.Net.Sockets.TcpListener uses 
the default network interface to listen for connections on the specified port 
number. The port on which to listen. If this number is 0, a port number will be 
selected at random. 

TcpListener 

Example Syntax: 

ToString 

[C#] public TcpListener(IPEndPoint localEP); 

[C++] pubhc: TcpListener(IPEndPoint'*= localEP); 

[ VB] PubUc Sub New(ByVal localEP As IPEndPoint) 

[ JScript] public function TcpListener(localEP : IPEndPoint); Initializes a new 

instance of the System.Net.Sockets.TcpListener class. 

Description 

Initializes a new instance of the System.Net.Sockets.TcpListener class 
with the specified local endpoint. 

The localEP parameter specifies the local endpoint. This constructor sets 
the underlying System.Net.Sockets.IPEndPoint of 

System.Net.Sockets.TcpListener to the specified local endpoint. If you call 
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System.Net.Sockets.TcpListener.Start , System.NetSockets.TcpListener will 
listen for connections using this endpoint. The localend point to bind the Hstener 
connection to. 

TcpListener 

Example Syntax: 

ToString 

[C#] public TcpListener(IP Address localaddr, int port); 

[C++] pubhc: TcpListener(IP Address* localaddr, int port); 

[VB] Public Sub New(ByVal localaddr As IPAddress, ByVal port As Integer) 

[JScript] public function TcpListener(localaddr : IPAddress, port : int); 

Description 

Initializes a new instance of the System.Net.Sockets.TcpListener class 
that listens to the specified IP address and port. 

This constructor instantiates the underlying 
System.Net.Sockets.IPEndPoiiit of System.Net.Sockets.TcpListener using the 
specified IP address and port number. If you call 

System.Net.Sockets.TcpListener.Start ,System.Net.Sockets.TcpListener 

listens for connections using the underlying endpoint. The local IP address to 
hsten to. The port on which to listen. If this is set to 0, a port number will be 
selected at random. 

Active 

ToString 
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[C#] protected bool Active {get;} 

[C++] protected: property bool get_Active(); 

[VB] Protected ReadOnly Property Active As Boolean 
[JScript] protected function get ActiveQ : Boolean; 

Description 

Gets or Sets a value that indicates whether 
System.Net.Sockets.TcpListener is actively Hstening for client connections. 

LocalEndpoint 

ToString 

[C#] public EndPoint LocalEndpoint {get;} 
[C++] public: _property EndPoint* get LocalEndpointQ; 
[VB] Public Readonly Property LocalEndpoint As EndPoint 
[JScript] pubMc function get LocalEndpointQ : EndPoint; 

Description 

Gets the underlying System.Net.Sockets.EndPoint of 
System.Net.Sockets.TcpListener . 

Server 
ToString 

[C#] protected Socket Server {get;} 

[C++] protected: _property Socket* get_Server(); 
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[VB] Protected ReadOnly Property Server As Socket 
[JScript] protected function get Server() : Socket; 

Description 

Used by the class to get or set the underlying network socket. 
Use this property to get the underlying System.Net.Sockets.Socket 
instance of System.Net.Sockets.TcpListener . 
AcceptSocket 

[C#] public Socket AcceptSocketQ; 

[C++] pubhc: Socket* AcceptSocketQ; 

[VB] Public Function AcceptSocketQ As Socket 

[JScript] public function AcceptSocketQ : Socket; 

Description 

Accepts a pending connection request. 
Return Value: A System.Net.Sockets.Socket instance to handle the incoming 

connection request. 

Systeiii.Net.Sockets.TcpListener.AcceptSocket returns a 

System.Net.Sockets.SDcket instance used to facihtate communication with the 
connecting client. This Systein.Net.Sockets.Socket is initialized with the IP 
Address and port number of the connecting client. You can use any of the 
System.Net.Sockets.Socket.Send(System.Byte[],System.Iiit32,System.Net.Sock 

ets.SocketFlags) and 

System.Net.Sockets.Socket.Receive(System.Byte[l,Systein.Int32,System.Net.S 
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ockets.SocketFlags) methods available in the System.Net.Sockets.Socket class to 
facilitate communication. 
AcceptTcpClient 

[C#] public TcpClient AcceptTcpClientQ; 

[CH-+] public: TcpClient* AcceptTcpClient(); 

[VB] Public Function AcceptTcpChentQ As TcpClient 

[JScript] public function AcceptTcpClient() : TcpClient; 

Description 

Accepts a pending connection request 
Return Value: A System.NetSockets.TcpClient instance to handle the incoming 
connection request. 

System*NetSockets.TcpListenenAcceptTcpClient returns 
System*Net.Sockets.TcpClient instance used to facilitate communication with the 
connecting client. Use System.Net.Sockets.TcpClient.GetStream to obtain the 
underlying System.Net.Sockets.NetworkStream instance of 
System.Net.Sockets.TcpCiient . You can use this 

System.Net.Sockets.TcpClient.NetworkStream to facilitate communication with 
the client. 

Finalize 

[C#] -TcpListenerO; 

[C++] ^TcpListenerO; 

[VB] Overrides Protected Sub FinalizeQ 
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1 [JScript] protected override function FinalizeQ; 



2 

3 II Description 

4 



Frees resources used by the System.Net.Sockets.TcpClient class. 
The fmalizer for the System.Net.Sockets.TcpListener class calls the 
6 II System.Net.Sockets.TcpListener.Stop method to free the underlying 
711 System.Net.Sockets.Socket . 

Pending 

9| 

10 I [C#] public bool PendingO; 

11 [C++] pubhc: bool PendingQ; 

12 [VB] Pubhc Function PendingQ As Boolean 

13 I [JScript] public function PendingQ : Boolean; 

14 

15 11 Description 

16 1 1 Determine if there are pending connection requests. 

Return Value: true if connections are pending; otherwise, false . 

Before System.Net.Sockets.TcpListener can poll for client connection 
attempts, it must first initialize its underlying System.Net.Sockets.Socket instance 
20 II to listen for incoming connection requests. The way you inititailize the underlying 
21 II System.Net.Sockets.Socket is by calling the 
22 II System.Net.Sockets.TcpListener.Start method. 
23 1 1 Start 

24 

25 1 [C#] pubhc void StartQ; 



17 



18 



19 



Iee@haye5 piic 509.324.9256 



2324 



MS1-862US.APP 



[C++] public: void StartQ; 
[VB] Public Sub StartQ 
[JScript] public function StartQ; 

Description 

Starts listening to network requests. 

System.Net.Sockets.TcpListener.Start initializes the underlying 
System.Net.Sockets.Socket instance. After this initialization, 
Systein.Net.Sockets.Start does the following: Binds the underlying 
System.Net.Sockets.Socket instance using the underlying 
System.Net.Sockets.IPEndPoint instance Begins listening for client connections 
by calling the System.Net.Sockets.Socket.Listen(Systein.Int32) method of the 
underlying System.Net.Sockets.Socket instance. 

Stop 

[C#] public void StopQ; 
[C++] public: void StopQ; 
[VB] Public Sub StopQ 
[JScript] public function StopQ; 

Description 

Closes the network connection. 
Close closes the network connection. 
UdpCMent class (System.Net.Sockets) 
ToString 
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Description 

Provides UDP (User Datagram Protocol) network services. 

The System.Net.Sockets.UdpClient class builds upon the 
System.Net.Sockets.Socket class to provide UDP services at a higher level of 
abstraction. Because UDP is a connectionless transport protocol, you do not need 
to establish a remote host connection prior to sending and receiving data. You do 
however, have the option to establish a System.Net.Sockets.UdpClient 
connection with a remote host using one of the following ways. 

UdpClient 

Example Syntax: 

ToString 

[C#] public UdpClientO; 
[C4-+] pubHc: UdpClientO; 
[VB] Public Sub NewQ 

[JScript] public function UdpClientQ; Initializes a new instance of the 
System.Net.Sockets.UdpClient class. 

Description 

Initializes a new instance of the System.Net.Sockets.UdpClient class. 
The default constructor sets the IP address to Systein.Net.IPAddress.Any 

and the port number to 0. 
UdpClient 
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Example Syntax: 
ToString 

[C#] public UdpClient(int port); 

[C++] public: UdpClient(mt port); 

[VB] Public Sub New(ByVal port As Integer) 

[JScript] public fimction UdpClient(port : int); 

Description 

Initializes a new instance of the System.Net.Sockets.UdpClient class that 
communicates on a specified port. 

T\\Qport parameter specifies the local port number on which you intend to 
communicate. This constructor instantiates an underlying 

System.Net.Sockets.Socket and binds that System.Net.Sockets.Socket using the 
provided port number. This constructor configures the underlying 
System.Net.Sockets.Socket to use the default local network interface for 
communication. The local port number from which you intend to communicate. 

UdpClient 

Example Syntax: 

ToString 

[C#] pubHc UdpChent(IPEndPoint localEP); 
[C++] public: UdpClient(IPEndPoint* localEP); 
[VB] Public Sub New(ByVal localEP As IPEndPoint) 
[JScript] public function UdpClient(localEP : IPEndPoint); 
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Description 

Initializes a new instance of the Systeiii.Net.Sockets.UdpClieiit class that 
communicates on a specified local endpoint. 

The localEP parameter specifies the local end point. This constructor 
instantiates a socket and binds that socket to the local end point provided. The 
local endpoint to which you bind the Udp connection. 

UdpClient 

Example Syntax: 

ToString 

[C#] public UdpClient(string hostname, int port); 

[C++] public: UdpClient(String* hostname, int port); 

[VB] Public Sub New(ByVal hostname As String, ByVal port As Integer) 

[JScript] public function UdpClient(hostname : String, port : int); 

Description 

Initializes anew instance of the System.Net.Sockets.UdpClient class and 
connects to a specified remote host on a specified port. 

This constructor accepts two parameters. The remote host name to which 
you intend to connect The remote port number to which you intend to connect 

Active 

ToString 

[C#] protected bool Active {get; set;} 
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[C++] protected: property bool get_Active();protected: _property void 
set_Active(bool); 

[VB] Protected Property Active As Boolean 

[JScript] protected function get ActiveQ : Boolean;protected function set 
Active(Boolean); 

Description 

Gets or sets a value indicating whether a connection to a remote host has 
been made. 
Client 
ToString 

[C#] protected Socket CUent {get; set;} 

[C++] protected: property Socket* get_Client();protected: property void 
set_Client(Socket*); 

[VB] Protected Property Client As Socket 

[JScript] protected function get CHentQ : Socket;protected function set 
Client(Socket); 

Description 

Gets or sets the underlying network socket. 

System.Net.Sockets.UdpCIieiit creates a System.Net.Sockets.Socket 

instance to handle the actual sending and receiving of data over a network. 
Close 
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[C#] public void CloseQ; 
[C++] public: void CloseQ; 
[VB] Public Sub CloseQ 
[JScript] public function CloseQ; 

Description 

Closes the UDP connection. 

System.Net.Sockets.TcpClient.Close disposes the UDP connection. 
Connect 

[C#] public void Connect(IPEndPoint endPoint); 
[C++] public: void Connect(IPEndPoint* endPoint); 
[VB] Public Sub Connect(ByVal endPoint As IPEndPoint) 
[JScript] public function Connect(endPoint : IPEndPoint); 

Description 

Connects the client to a remote UDP host using the specified remote 
network endpoint. 

System.NetSockets.UdpClientConnect(System.String,SystemJiit32) 

establishes a UDP connection to the host using the specified 
System.Net JPEndPoint . The network endpoint to which you intend to connect. 
Connect 

[C#] pubhc void Connect(IP Address addr, int port); 
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[C++] public: void Connect(IP Address* addr, intport); 

[VB] Public Sub Connect(ByVal addr As IP Address, ByVal port As Integer) 

[JScript] public function Connect(addr : IP Address, port : int); 

Description 

Connects the client to a remote UDP host using the specified IP Address 
and port number. 

System.Net.Sockets.TcpClient.Connect(System.Strmg,System.Int32) 

establishes a UDP connection using the port and IP address specified. This method 
estabHshes a connection by calling the 

System.Net.Sockets.Socket.Connect(Sy stein.Net.EndPoint) method of the 
underlying System.Net.Sockets.Socket instance. After a connection is 
established, you can use the 

System.Net.Sockets.UdpClieiit.Send(System.Byte[],System.Int32,System.Net.I 
PEndPoint) and 

System.Net.Sockets.UdpClient.Receive(System.Net.IPEndPoint@) methods to 
communicate with the remote host. IP address of the host to which you intend to 
connect. The port number to which you intend to connect. 
Connect 

[C#] public void Connect(string hostname, int port); 

[C++] public: void Connect(String* hostname, int port); 

[VB] Public Sub Connect(ByVal hostname As String, ByVal port As Integer) 

[JScript] pubhc function Connect(hostname : String, port : int); EstabHshes a 

connection to a remote host. 
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Description 

Establishes a connection to the specified port on the specified remote host. 

System.Net.Sockets.TcpClient.Connect(System.String,System.Int32) 
establishes a UDP connection to the host machine using the specified port and 
hostname . This method establishes a connection by calling the 
System.Net.Sockets.Socket.Connect(System.Net.EndPoint) method of the 
underlying System.Net.Sockets.Socket instance. Once a connection is 
established, you can use the 

System.Net.Sockets.UdpClieiit.Send(System.Byte[],System.Iiit32,System.Net.I 
PEndPoint) and 

System.Net.Sockets.UdpClient.Receive(System.Net.IPEndPoint@) methods to 
communicate with the remote host. Name of the remote host to which you intend 
to connect. Port number on the remote host to which you intend to connect. 
DropMulticastGroup 

[C#] public void DropMulticastGroup(IP Address multicastAddr); 
[C++] public: void DropMulticastGroup(IP Address* multicastAddr); 
[VB] Public Sub DropMulticastGroup(ByVal multicastAddr As IP Address) 
[JScript] pubHc function DropMulticastGroup(multicastAddr : IPAddress); 

Description 

Leaves a multicast group. 

System.Net.Sockets.UdpClient.DropMulticastGroup(System.Net.IPAd 
dress) disassociates a System.Net.Sockets.UdpClient instance with a multicast 
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group. In order to remove the System.Net.Sockets.UdpClient instance from a 
multicast group, you must call 

System.Net.Sockets.UdpClient.DropMulticastGroup(Systein.Net.IPAddress) 
using the System.Net.Sockets.IP Address of the group from which you intend to 
withdrawal. The System.NetlPAddressof the multicast group to leave. 
JoinMulticastGroup 

[C#] public void JoinMulticastGroup(IP Address multicastAddr); 
[C++] pubhc: void JoinMulticastGroup(IPAddress* multicastAddr); 
[VB] Public Sub JoinMulticastGroup(ByVal multicastAddr As IPAddress) 
[JScript] public fiinction JoinMulticastGroup(multicastAddr : IPAddress); Adds a 
System.Net.Sockets.UdpClieiit to a multicast group. 

Description 

Adds a System.Net.Sockets.UdpClient to a multicast group. 
System.Net.Sockets.UdpClient.JoinMulticastGroup(System.Net.IPAdd 

ress) associates the System.Net.Sockets.UdpClient instance with a multicast 

group. In order to receive data from this group, you must call 
System.Net.Sockets.UdpClient.JoinMulticastGroup(System.Net.IP Address) 

using the System.Net.Sockets.IP Address of the group to which you intend to 

join. The multicast System.Net.Sockets.IP Address of the group you wish to join. 

JoinMulticastGroup 

[C#] pubhc void JoinMulticastGroup(IP Address multicastAddr, int timeToLive); 
[C++] public: void JoinMulticastGroup(IP Address* multicastAddr, int 
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timeToLive); 

[VB] Public Sub JoinMulticastGroup(ByVal multicastAddr As IP Address, ByVal 
timeToLive As Integer) 

[JScript] public function JoinMulticastGroup(multicastAddr : IP Address, 
timeToLive : int); 

Description 

Adds a Systein.Net.Sockets.UdpClient to a multicast group with the 

specified Time to Live (TTL). 

Systein.Net.Sockets.UdpClient.JoinMulticastGroup(System.Net.IPAdd 

ress) associates the System.Net.Sockets.UdpClient instance with a multicast 

group. This overload requires two parameters. The System.Net.IP Address of the 

multicast group to join. The Time to Live (TTL) 

Receive 

[C#] public byte[] Receive(ref IPEndPoint remoteEP); 
[C++] public: unsigned char Receive(IPEndPoint** remoteEP) __gc[]; 
[VB] Public Function Receive(ByRef remoteEP As IPEndPoint) As ByteQ 
[JScript] public function Receive(remoteEP : IPEndPoint) : Byte[]; 

Description 

Returns a UDP datagram that was sent by a remote host. 
Return Value: An array of 8-bit unsigned integers that contains the datagram data. 
An System.Net.IPEndPoint representing the remote host firom which the data 
was sent. 
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Send 



[C#] public int Send(byte[] dgram, int bytes); 

[C++] public: int Send(unsigned char dgram _gc[], int bytes); 

[VB] Public Function Send(ByVal dgramQ As Byte, ByVal bytes As Integer) As 

Integer 

[JScript] public function Send(dgram : Byte[], bytes : int) : int; 

Description 

Sends a UDP datagram to a remote host. 

Return Value: The number of bytes sent. 

System.Net.Sockets.UdpClient.Send(System.Byte[],System.Iiit32,Syste 

m.Net.IPEndPoint) sends the provided datagram to a remote host. Before using 
System.Net.Sockets.UdpClieiit.Send(System.Byte[],System.Iiit32,System.Net.I 

PEndPoint) , you must first use 

System.Net.Sockets.UdpCUeiit.Connect(System.String,System.Int32)to 

establish a remote host connection. The UDP datagram that you intend to send. 
The number of bytes in the datagram. 
Send 

[C#] pubHc int Send(byte[] dgram, int bytes, IPEndPoint endPoint); 
[C++] public: int Send(unsigned char dgram _gc[], int bytes, IPEndPoint* 
endPoint); 

[VB] Public Function Send(ByVal dgramQ As Byte, ByVal bytes As Integer, 
ByVal endPoint As IPEndPoint) As Integer 
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[JScript] public function Send(dgram : Byte[], bytes : int, endPoint : IPEndPoint) : 
int; Sends a UDP datagram to a remote host. 

Description 

Sends a UDP datagram to the host that is at the remote endpoint. 
Return Value: The number of bytes sent. 
The 

System.Net.Sockets.UdpCIieiit.Send(System.Byte[],System.Int32,System.Net.I 
PEndPoint) method establishes a UDP connection to the remote host using the 
specified System.Net.IPEndPoint , and then sends the datagram. The UDP 
datagram to send. The number of bytes in the datagram. An 
System.Net.IPEndPoint that represents the host and port to which to send the 
datagram. 
Send 

[C#] pubUc int Send(byte[] dgram, int bytes, string hostname, int port); 

[C++] public: int Send(unsigned char dgram _gc[], int bytes, String* hostname, 

int port); 

[VB] Public Function Send(ByVal dgram() As Byte, ByVal bytes As Integer, 
ByVal hostname As String, ByVal port As Integer) As Integer 
[JScript] public function Send(dgram : Byte[], bytes : int, hostname : String, port : 
int) : int; 

Description 
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Sends a UDP datagram to a specified port on a specified remote host. 

Return Value: The number of bytes sent. 

System,Net.Sockets.U(lpClieiit.Send(System.Byte[],System.Int32,Syste 

m.Net.IPEndPoint) establishes a UDP connection to the specified host and port 

and then sends the datagram. The data is sent by caUing the 
Systeiii.Net.Sockets.Socket.SendTo(System.Byte[],System.Iiit32,System.Iiit32, 

System.Net.Sockets.SocketFlags,Systein.Net.EndPoint) method of the 

underlying System.Net.Sockets.Socket instance. The UDP datagram to send. 

System.Security Namespace 

The System.Security namespace provides the underlying structure of the 
security system, including base classes for permissions. Cryptographic classes in 
the namespace are integrated with streams, allowing the classes to be used with 
file or network I/O seamlessly. Additionally, security is made available due to 
isolated storage that allows code running with restricted permissions to use its own 
private file system. Furthermore, a role-based user identity programming model is 
unified across different underlying authentication technologies, enabhng 
applications to write to a single API that works for all the authentication 
technologies. As part of this role-based user identity programming model, an 
Ildentity interface defines the basic fimctionality of an identity object (which 
represents the user on whose behalf the code is running), and an IPrincipal 
interface defines the basic functionality of a principal object (which represents the 
security context of the user on whose behalf the code is running, including that 
user's identity (Ildentity) and any roles to which the user belongs). 
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The System.Security namespace includes a System.Security.Cryptography 
namespace, a System.Security.Cryptography.X509Certificates namespace, a 
System.Security.Cryptography.Xml namespace, a System.Security.Permissions 
namespace, a System.Security.Policy namespace, and a System.Security .Principal 
namespace. 

The System. Security.Cryptography namespace provides cryptographic 
services, including secure encoding and decoding of data, as well as many other 
operations, such as hashing, random number generation, and message 
authentication. The System.Security.Cryptography.X509Certificates namespace 
contains the common language runtime implementation of the Authenticode X.509 
V.3 certificate. This certificate is signed with a private key, uniquely and 
positively identifying the holder of the certificate. The 
System.Security.Cryptography.Xml namespace contains an XML model for use 
within the .net framework security system, allowing XML objects to be signed 
with a digital signature. 

The System. Security.Permissions namespace defines classes that control 
access to operations and resources based on policy. The System.Security.Policy 
namespace contains three types of classes: code groups, membership conditions, 
and evidence. These three types of classes are used to create the rules applied by 
the common language runtime security poKcy system. Evidence classes are the 
input to security policy and membership conditions are the switches; together 
these create poHcy statements and determine the granted permission set. Policy 
levels and code groups are the structure of the policy hierarchy. Code groups are 
the encapsulation of a rule and are arranged hierarchically in a policy level. The 
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System.Security .Principal namespace defines a principal object that represents the 
security context under which code is running. 

SYSTEM.MANAGEMENT NAMESPACE 

The System.Management namespace includes numerous objects and 
methods that enable rich management through late binding to WMI providers. 
Various management functionality and capacity is made available, including 
standard querying on management data, events-publication/subscription, 
management data retrieval, method invocation (system reboots, process kill, etc.), 
system/application configuration, discoverability through common schema, 
support for management relationship hierarchies, etc. 

Numerous objects representing management instrumentation are accessible 
through the System.Management namespace (which includes the 
System.Management.Instrumentation namespace), from configuration to events 
that can be consumed by .NET clients to manage devices. The 
System.Management namespace exposes multiple classes (e.g., 
ManagementObjectO and ManagementObjectSearcherQ, etc.) that allow client 
devices to query and enumerate through management classes and invoke methods, 
write configurations, subscribe for events, etc. Examples of this functionality 
include: SNMP management (traps, etc.); WDM management (windows drivers); 
MSI management (windows installer); DS management (directory services); 
Security settings management; Network Adapters/bindings management; 
Computer System management; Memory, CPU, Processor, and Disks 
management; File and directory management; Application management; System 
Device management; and so forth. 



lee@hayes (Hc sci9.32«256 



2339 



MS1-862U5.APP 



System.ServiceProcess Namespace 

As discussed above, the System.ServiceProcess namespace contains classes 
that allow developers to install and run services. These allow services (e.g., 
Windows NT® operating system services) to be written, installed, and run 
relatively easily. These also allow custom installation actions for services to be 
packaged into assemblies, easing the installation process. 

SYSTEM.RUNTIME.SERIALIZATION NAMESPACE 

The System.Runtime. Serialization namespace contains classes that can be 
used for serializing and deserializing objects in a relatively simple manner. 
Serialization is the process of converting an object or a graph of objects into a 
linear sequence of bytes for either storage or transmission to another location. 
Deserialization is the process of taking in stored information and recreating 
objects from it. An ISerializable interface provides a way for classes to control 
their own seriaHzation behavior. The System.Runtime. Serialization namespace 
includes three additional namespaces: the 

System.Runtime.Serialization.Formatters namespace (which contains common 
enumerations, interfaces and classes that are used by seriahzation formatters), the 
System.Runtime.Serialization.Formatters.Binary namespace (which contains a 
BinaryFormatter class that can be used to serialize and deserialize objects in 
binary format), and the System.Runtime.Serialization.Formatters.Soap namespace 
(which contains a SoapFormatter class that can be used to serialize and deserialize 
objects in the SOAP format). 
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SYSTEM.MESSAGING NAMESPACE 

The SystemMessaging namespace provides classes that allow connecting 
to message queues on the network, sending messages to queues, receiving 
messages from queues, and peeking at (reading without removing) messages from 
queues. A MessageQueue class supports both synchronous and asynchronous 
retrieval of messages from a queue. Peek and Receive methods on the 
MessageQueue class interrupt processing until a message is available in the queue 
(or until a specified timeout expires), while BeginPeek and BeginReceive methods 
on the MessageQueue class allow processing to continue and use event 
notification or callbacks to indicate that a message exists or has arrived in the 
queue. MessageQueue use an internal connection cache (or pool), allowing 
repeated instantiation of MessageQueue to bind to the same queue very quickly 
Additionally, any object can be sent or received as a message, and the object on 
the server and client can be of a different type (as long as the schemas are the 
same). 

The MessageQueue class and Message class are the primary classes that 
provide the fimctionality for message queuing. MessageQueue provides a means 
for getting and setting queue properties and default message properties, as well as 
initiating message send, peek, or receive operations. MessageQueue also provides 
support for transactional message processing. The Message class is used to peek 
or receive messages from a queue, or to have fine control over message properties 
when sending a message to a queue. 

System.Diagnostics Namespace 
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As discussed above, the System.Diagnostics namespace contains classes 
that are used to debug applications and to trace code execution, as well as start 
system processes, read and write to event logs, and monitor system performance. 
These classes allow, for example, easy publishing of performance counter data and 
writing to event logs (e.g., without having to generate separate dll's in order to do 
so). A Trace class contains a set of methods and properties that help a developer 
trace the execution of code. A Debug class contains a set of methods and 
properties that help a developer debug code. A Process class enables access to 
local and remote processes, allowing a developer to start and stop local system 
processes. An EventLog class enables interaction with Windows® operating 
systems event logs, which record information about important software or 
hardware events. A PerformanceCounter class represents a Windows NT® 
operating system performance counter component that can be used for both 
reading existing predefined or custom counters and pubhshing (writing) 
performance data to custom counters. 

Exemplary Computing System and Environment 

Fig. 4 illustrates an example of a suitable computing environment 400 
within which the programming firamework 132 may be implemented (either fiilly 
or partially). The computing environment 400 may be utilized in the computer 
and network architectures described herein. 

The exemplary computing environment 400 is only one example of a 
computing environment and is not intended to suggest any limitation as to the 
scope of use or functionality of the computer and network architectures. Neither 
should the computing environment 400 be interpreted as having any dependency 
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or requirement relating to any one or combination of components illustrated in the 
exemplary computing environment 400. 

The framework 132 may be implemented with numerous other general 
purpose or special purpose computing system environments or configurations. 
Examples of well known computing systems, environments, and/or configurations 
that may be suitable for use include, but are not limited to, personal computers, 
server computers, multiprocessor systems, microprocessor-based systems, network 
PCs, minicomputers, mainframe computers, distributed computing environments 
that include any of the above systems or devices, and so on. Compact or subset 
versions of the framework may also be implemented in clients of limited 
resources, such as cellular phones, personal digital assistants, handheld computers, 
or other communication/computing devices. 

The framework 132 may be described in the general context of computer- 
executable instructions, such as program modules, being executed by one or more 
computers or other devices. Generally, program modules include routines, 
programs, objects, components, data structures, etc. that perform particular tasks 
or implement particular abstract data types. The framework 132 may also be 
practiced in distributed computing environments where tasks are performed by 
remote processing devices that are linked through a communications network. In 
a distributed computing environment, program modules may be located in both 
local and remote computer storage media including memory storage devices. 

The computing environment 400 includes a general-purpose computing 
device in the form of a computer 402. The components of computer 402 can 
include, by are not limited to, one or more processors or processing units 404, a 
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system memory 406, and a system bus 408 that couples various system 
components including the processor 404 to the system memory 406. 

The system bus 408 represents one or more of several possible types of bus 
structures, including a memory bus or memory controller, a peripheral bus, an 
accelerated graphics port, and a processor or local bus using any of a variety of 
bus architectures. By way of example, such architectures can include an Industry 
Standard Architecture (ISA) bus, a Micro Channel Architecture (MCA) bus, an 
Enhanced ISA (EISA) bus, a Video Electronics Standards Association (VESA) 
local bus, and a Peripheral Component Interconnects (PCI) bus also known as a 

10 Mezzanine bus. 

Computer 402 typically includes a variety of computer readable media. 
Such media can be any available media that is accessible by computer 402 and 
includes both volatile and non-volatile media, removable and non-removable 
media. 

The system memory 406 includes computer readable media in the form of 
volatile memory, such as random access memory (RAM) 410, and/or non-volatile 
memory, such as read only memory (ROM) 412. A basic input/output system 
(BIOS) 414, containing the basic routines that help to transfer information 
between elements within computer 402, such as during start-up, is stored in ROM 
412. RAM 410 typically contains data and/or program modules that are 
immediately accessible to and/or presently operated on by the processing unit 404. 

Computer 402 may also include other removable/non-removable, 
volatile/non-volatile computer storage media. By way of example, Fig. 4 
illustrates a hard disk drive 416 for reading from and writing to a non-removable, 
non-volatile magnetic media (not shown), a magnetic disk drive 418 for reading 
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from and writing to a removable, non-volatile magnetic disk 420 (e.g., a "floppy 
disk"), and an optical disk drive 422 for reading from and/or writing to a 
removable, non-volatile optical disk 424 such as a CD-ROM, DVD-ROM, or other 
optical media. The hard disk drive 416, magnetic disk drive 418, and optical disk 
drive 422 are each connected to the system bus 408 by one or more data media 
interfaces 426. Alternatively, the hard disk drive 416, magnetic disk drive 418, 
and optical disk drive 422 can be connected to the system bus 408 by one or more 

interfaces (not shown). 

The disk drives and their associated computer-readable media provide non- 
volatile storage of computer readable instructions, data structures, program 
modules, and other data for computer 402. Although the example illustrates a 
hard disk 416, a removable magnetic disk 420, and a removable optical disk 424, 
it is to be appreciated that other types of computer readable media which can store 
data that is accessible by a computer, such as magnetic cassettes or other magnetic 
storage devices, flash memory cards, CD-ROM, digital versatile disks (DVD) or 
other optical storage, random access memories (RAM), read only memories 
(ROM), electrically erasable programmable read-only memory (EEPROM), and 
the like, can also be utilized to implement the exemplary computing system and 
environment. 

Any number of program modules can be stored on the hard disk 416, 
magnetic disk 420, optical disk 424, ROM 412, and/or RAM 410, including by 
way of example, an operating system 426, one or more appUcation programs 428, 
other program modules 430, and program data 432. Each of the operating system 
426, one or more application programs 428, other program modules 430, and 
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program data 432 (or some combination thereof) may include elements of the 
programming framework 132. 

A user can enter commands and information into computer 402 via input 
devices such as a keyboard 434 and a pointing device 436 (e.g., a "mouse"). 
Other input devices 438 (not shown specifically) may include a microphone, 
joystick, game pad, satellite dish, serial port, scanner, and/or the like. These and 
other input devices are connected to the processing unit 404 via input/output 
interfaces 440 that are coupled to the system bus 408, but may be connected by 
other interface and bus structures, such as a parallel port, game port, or a universal 
serial bus (USB). 

A monitor 442 or other type of display device can also be connected to the 
system bus 408 via an interface, such as a video adapter 444. In addition to the 
monitor 442, other output peripheral devices can include components such as 
speakers (not shown) and a printer 446 which can be connected to computer 402 
via the input/output interfaces 440. 

Computer 402 can operate in a networked environment using logical 
connections to one or more remote computers, such as a remote computing device 
448. By way of example, the remote computing device 448 can be a personal 
computer, portable computer, a server, a router, a network computer, a peer device 
or other common network node, and so on. The remote computing device 448 is 
illustrated as a portable computer that can include many or all of the elements and 
features described herein relative to computer 402. 

Logical connections between computer 402 and the remote computer 448 
are depicted as a local area network (LAN) 450 and a general wide area network 
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(WAN) 452. Such networking environments are commonplace in offices, 
enterprise-wide computer networks, intranets, and the Internet. 

When implemented in a LAN networking environment, the computer 402 is 
connected to a local network 450 via a network interface or adapter 454. When 
implemented in a WAN networking environment, the computer 402 typically 
includes a modem 456 or other means for establishing communications over the 
wide network 452. The modem 456, which can be internal or external to computer 
402, can be connected to the system bus 408 via the input/output interfaces 440 or 
other appropriate mechanisms. It is to be appreciated that the illustrated network 
connections are exemplary and that other means of establishing communication 
link(s) between the computers 402 and 448 can be employed. 

In a networked environment, such as that illustrated with computing 
environment 400, program modules depicted relative to the computer 402, or 
portions thereof, may be stored in a remote memory storage device. By way of 
example, remote appHcation programs 458 reside on a memory device of remote 
computer 448. For purposes of illustration, appHcation programs and other 
executable program components such as the operating system are illustrated herein 
as discrete blocks, although it is recognized that such programs and components 
reside at various times in different storage components of the computing device 
402, and are executed by the data processor(s) of the computer. 

An implementation of the framework 132, and particularly, the API 142 or 
calls made to the API 142, may be stored on or transmitted across some form of 
computer readable media. Computer readable media can be any available media 
that can be accessed by a computer. By way of example, and not limitation, 
computer readable media may comprise "computer storage media" and 
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"communications media." "Computer storage media" include volatile and non- 
volatile, removable and non-removable media implemented in any method or 
technology for storage of information such as computer readable instructions, data 
structures, program modules, or other data. Computer storage media includes, but 
is not limited to, RAM, ROM, EEPROM, flash memory or other memory 
technology, CD-ROM, digital versatile disks (DVD) or other optical storage, 
magnetic cassettes, magnetic tape, magnetic disk storage or other magnetic storage 
devices, or any other medium which can be used to store the desired information 
and which can be accessed by a computer. 

"Communication media" typically embodies computer readable 
instructions, data structures, program modules, or other data in a modulated data 
signal, such as carrier wave or other transport mechanism. Communication media 
also includes any information delivery media. The term "modulated data signal" 
means a signal that has one or more of its characteristics set or changed in such a 
manner as to encode information in the signal. By way of example, and not 
limitation, communication media includes wired media such as a wired network or 
direct-wired connection, and wireless media such as acoustic, RF, infrared, and 
other wireless media. Combinations of any of the above are also included within 
the scope of computer readable media. 

Alternatively, portions of the framework may be implemented in hardware 
or a combination of hardware, software, and/or firmware. For example, one or 
more application specific integrated circuits (ASICs) or programmable logic 
devices (PLDs) could be designed or programmed to implement one or more 
portions of the framework. 
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Conclusion 

Although the invention has been described in language specific to structural 
features and/or methodological acts, it is to be understood that the invention 
defined in the appended claims is not necessarily limited to the specific features or 
acts described. Rather, the specific features and acts are disclosed as exemplary 
forms of implementing the claimed invention. 
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